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.
addEventListener("error", (event) => {});
onerror = (event) => {};
Ereignistyp
Ein SpeechSynthesisErrorEvent
. Erbt von SpeechSynthesisEvent
und Event
.
Ereigniseigenschaften
Neben den unten aufgeführten Eigenschaften sind Eigenschaften der übergeordneten Schnittstelle, Event
, verfügbar.
charIndex
Nur lesbar-
Gibt die Indexposition des Zeichens in der
SpeechSynthesisUtterance.text
zurück, das gesprochen wurde, als das Ereignis ausgelöst wurde. elapsedTime
Nur lesbar-
Gibt die verstrichene Zeit in Sekunden zurück, nachdem die
SpeechSynthesisUtterance.text
zu sprechen begonnen wurde, dass das Ereignis ausgelöst wurde. error
Nur lesbar-
Gibt einen Fehlercode zurück, der angibt, was bei einem Sprachsyntheseversuch schiefgelaufen ist.
name
Nur lesbar-
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 einesmark
-Ereignisses erreicht wurde, oder die Art der Grenze, die im Fall einesboundary
-Ereignisses erreicht wurde. utterance
Nur lesbar-
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:
utterThis.addEventListener("error", (event) => {
console.log(
`An error has occurred with the speech synthesis: ${event.error}`,
);
});
Oder die onerror
-Ereignishandler-Eigenschaft verwenden:
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