SpeechSynthesisUtterance: error-Event
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit September 2018 browserübergreifend verfügbar.
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.
addEventListener("error", (event) => { })
onerror = (event) => { }
Ereignistyp
Ein SpeechSynthesisErrorEvent. Erbt von SpeechSynthesisEvent und Event.
Ereigniseigenschaften
Zusätzlich zu den unten aufgeführten Eigenschaften sind die Eigenschaften der Super-Schnittstelle Event verfügbar.
charIndexSchreibgeschützt-
Gibt die Indexposition des Zeichens im
SpeechSynthesisUtterance.textzurück, das gesprochen wurde, als das Ereignis ausgelöst wurde. elapsedTimeSchreibgeschützt-
Gibt die verstrichene Zeit in Sekunden zurück, nachdem das
SpeechSynthesisUtterance.textzu sprechen begonnen hat, die das Ereignis ausgelöst hat. errorSchreibgeschützt-
Gibt einen Fehlercode zurück, der angibt, was bei einem Sprachsynthesisversuch schief gelaufen ist.
nameSchreibgeschützt-
Gibt den Namen zurück, der mit bestimmten Ereignisarten verbunden ist, die bei der Aussprache des
SpeechSynthesisUtterance.textauftreten: der Name des SSML-Markers, der bei einemmark-Ereignis erreicht wurde, oder die Art der Grenze, die im Fall einesboundary-Ereignisses erreicht wird. utteranceSchreibgeschü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:
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
| Spezifikation |
|---|
| Web Speech API> # eventdef-speechsynthesisutterance-error> |
| Web Speech API> # dom-speechsynthesisutterance-onerror> |