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.
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 einemmark
-Ereignis erreicht wurde, oder die Art der Grenze, die im Fall einesboundary
-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:
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 |