SpeechSynthesisUtterance: error-Ereignis

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-Ereignis des SpeechSynthesisUtterance-Objekts der Web Speech API wird ausgelöst, wenn ein Fehler auftritt, der das erfolgreiche Sprechen der Äußerung verhindert.

Syntax

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

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

onerror = (event) => {};

Ereignistyp

Ereigniseigenschaften

Neben den unten aufgeführten Eigenschaften sind Eigenschaften der übergeordneten Schnittstelle, Event, verfügbar.

charIndex Schreibgeschützt

Gibt die Indexposition des Zeichens in der 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 die SpeechSynthesisUtterance.text zu sprechen begonnen wurde, dass das Ereignis ausgelöst wurde.

error Schreibgeschützt

Gibt einen Fehlercode zurück, der angibt, was bei einem Sprachsyntheseversuch schiefgelaufen ist.

name Schreibgeschützt

Gibt den Namen zurück, der bestimmten Arten von Ereignissen zugeordnet ist, die auftreten, während die SpeechSynthesisUtterance.text gesprochen wird: den Namen des SSML-Markers, der im Fall eines mark-Ereignisses erreicht wurde, oder die Art der Grenze, die im Fall eines boundary-Ereignisses erreicht wurde.

utterance Schreibgeschützt

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

Beispiele

Sie können das error-Ereignis 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

BCD tables only load in the browser

Siehe auch