MediaError: message-Eigenschaft

Ein String, der eine detaillierte, spezifische Erklärung bietet, was schiefgelaufen ist und möglicherweise, wie es behoben werden könnte. Dies ist nicht eine generische Beschreibung des Werts der MediaError.code Eigenschaft, sondern geht stattdessen tiefer in die Einzelheiten dieses speziellen Fehlers und seiner Umstände ein. Wenn keine spezifischen Details verfügbar sind, ist dieser String leer.

Dieses Beispiel erstellt ein <audio>-Element, richtet einen Fehlerbehandler dafür ein und lässt den Benutzer Schaltflächen anklicken, um zu wählen, ob der src-Attribut des Elements eine gültige Audiodatei oder eine fehlende Datei zugewiesen werden soll. Der Fehlerbehandler gibt eine Nachricht auf einem Bildschirm aus, die den Fehler beschreibt, einschließlich sowohl des Codes als auch der Nachricht.

Es werden nur die relevanten Teile des Codes angezeigt; Sie können den vollständigen Quellcode hier sehen.

Das Beispiel erstellt ein <audio>-Element und lässt den Benutzer entweder eine gültige Musikdatei oder einen Link zu einer nicht existierenden Datei zuweisen. Dies ermöglicht es uns, das Verhalten des error-Ereignishandlers zu sehen, das wir dem <audio>-Element selbst hinzufügen.

Der Fehlerbehandler sieht so aus:

audioElement.onerror = () => {
  let s = "";
  const err = audioElement.error;

  switch (err.code) {
    case MediaError.MEDIA_ERR_ABORTED:
      s += "The user canceled the audio.";
      break;
    case MediaError.MEDIA_ERR_NETWORK:
      s += "A network error occurred while fetching the audio.";
      break;
    case MediaError.MEDIA_ERR_DECODE:
      s += "An error occurred while decoding the audio.";
      break;
    case MediaError.MEDIA_ERR_SRC_NOT_SUPPORTED:
      s +=
        "The audio is missing or is in a format not supported by your browser.";
      break;
    default:
      s += "An unknown error occurred.";
      break;
  }

  const message = err.message;

  if (message?.length > 0) {
    s += ` ${message}`;
  }

  displayErrorMessage(`<strong>Error ${err.code}:</strong> ${s}<br>`);
};

Dies erhält das MediaError-Objekt, das den Fehler beschreibt, aus der error-Eigenschaft auf dem HTMLAudioElement, das den Audioplayer darstellt. Das code-Attribut des Fehlers wird überprüft, um eine generische Fehlermeldung anzuzeigen, und falls message nicht leer ist, wird diese zur Bereitstellung zusätzlicher Details angefügt. Dann wird der resultierende Text im Protokoll ausgegeben.

Sie können dieses Beispiel unten ausprobieren und das Beispiel in Aktion außerhalb dieser Seite hier sehen.

• MediaError: Schnittstelle zur Definition der MediaError.message-Eigenschaft
• <audio>, <video>