SpeechSynthesisUtterance: error-Event

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2018.

Das error-Event des SpeechSynthesisUtterance-Objekts der Web Speech API wird ausgelöst, wenn ein Fehler auftritt, der verhindert, dass der Ausdruck erfolgreich gesprochen wird.

Syntax

Verwenden Sie den Ereignisnamen in Methoden wie addEventListener() oder setzen Sie eine Ereignishandler-Eigenschaft.

js
addEventListener("error", (event) => { })

onerror = (event) => { }

Ereignistyp

Ereigniseigenschaften

Zusätzlich zu den unten aufgeführten Eigenschaften sind die Eigenschaften der Super-Schnittstelle Event verfügbar.

charIndex Schreibgeschützt

Gibt die Indexposition des Zeichens im SpeechSynthesisUtterance.text zurück, das gesprochen wurde, als das Ereignis ausgelöst wurde.

elapsedTime Schreibgeschützt

Gibt die verstrichene Zeit in Sekunden zurück, nachdem das SpeechSynthesisUtterance.text zu sprechen begonnen hat, die das Ereignis ausgelöst hat.

error Schreibgeschützt

Gibt einen Fehlercode zurück, der angibt, was bei einem Sprachsynthesisversuch schief gelaufen ist.

name Schreibgeschützt

Gibt den Namen zurück, der mit bestimmten Ereignisarten verbunden ist, die bei der Aussprache des SpeechSynthesisUtterance.text auftreten: der Name des SSML-Markers, der bei einem mark-Ereignis erreicht wurde, oder die Art der Grenze, die im Fall eines boundary-Ereignisses erreicht wird.

utterance Schreibgeschützt

Gibt die SpeechSynthesisUtterance-Instanz zurück, auf der das Ereignis ausgelöst wurde.

Beispiele

Sie können das error-Event in einer addEventListener-Methode verwenden:

js
utterThis.addEventListener("error", (event) => {
  console.log(
    `An error has occurred with the speech synthesis: ${event.error}`,
  );
});

Oder die onerror-Ereignishandler-Eigenschaft verwenden:

js
utterThis.onerror = (event) => {
  console.log(
    `An error has occurred with the speech synthesis: ${event.error}`,
  );
};

Spezifikationen

Specification
Web Speech API
# eventdef-speechsynthesisutterance-error
Web Speech API
# dom-speechsynthesisutterance-onerror

Browser-Kompatibilität

Siehe auch