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.
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
| Specification |
|---|
| Web Speech API> # eventdef-speechsynthesisutterance-error> |
| Web Speech API> # dom-speechsynthesisutterance-onerror> |
Browser-Kompatibilität
Loading…