SpeechSynthesisErrorEvent: SpeechSynthesisErrorEvent() Konstruktor

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.

Der SpeechSynthesisErrorEvent() Konstruktor erstellt ein neues SpeechSynthesisErrorEvent Objekt.

Hinweis: Ein Webentwickler muss diesen Konstruktor normalerweise nicht aufrufen, da der Browser diese Objekte selbst beim Auslösen von Ereignissen erstellt.

Syntax

new SpeechSynthesisErrorEvent(type, options)

Parameter

type

Ein String mit dem Namen des Ereignisses. Es ist groß-/kleinschreibungssensitiv und Browser setzen es auf error.

options

Ein Objekt, das zusätzlich zu den in SpeechSynthesisEvent() definierten Eigenschaften, die folgenden Eigenschaften hat:

error

Ein String, der den Grund des Fehlers enthält. Mögliche Werte sind:

canceled: Ein Aufruf der Methode SpeechSynthesis.cancel verursachte, dass das SpeechSynthesisUtterance aus der Warteschlange entfernt wurde, bevor die Sprache gestartet wurde.
interrupted: Ein Aufruf der Methode SpeechSynthesis.cancel verursachte, dass das SpeechSynthesisUtterance unterbrochen wurde, nachdem die Sprache gestartet, aber bevor sie beendet wurde.
audio-busy: Die Operation konnte derzeit nicht abgeschlossen werden, weil der User-Agent nicht auf das Audio-Ausgabegerät zugreifen konnte (zum Beispiel muss der Benutzer möglicherweise eine andere Anwendung schließen).
audio-hardware: Die Operation konnte derzeit nicht abgeschlossen werden, weil der User-Agent kein Audio-Ausgabegerät identifizieren konnte (zum Beispiel muss der Benutzer möglicherweise einen Lautsprecher anschließen oder Systemeinstellungen konfigurieren).
network: Die Operation konnte derzeit nicht abgeschlossen werden, weil eine erforderliche Netzkommunikation fehlgeschlagen ist.
synthesis-unavailable: Die Operation konnte derzeit nicht abgeschlossen werden, weil keine Synthesemaschine verfügbar war (zum Beispiel muss der Benutzer möglicherweise eine Synthesemaschine installieren oder konfigurieren).
synthesis-failed: Die Operation schlug fehl, weil die Synthesemaschine einen Fehler auslöste.
language-unavailable: Keine geeignete Stimme war für die in SpeechSynthesisUtterance.lang gesetzte Sprache verfügbar. Sie können die Methode window.speechSynthesis.getVoices() verwenden, um zu bestimmen, welche Stimmen und Sprachen im Browser des Benutzers unterstützt werden.
voice-unavailable: Die in SpeechSynthesisUtterance.voice gesetzte Stimme war nicht verfügbar.
text-too-long: Der Inhalt des Attributs SpeechSynthesisUtterance.text war zu lang, um synthetisiert zu werden.
invalid-argument: Der Inhalt der Eigenschaft SpeechSynthesisUtterance.rate, SpeechSynthesisUtterance.pitch oder SpeechSynthesisUtterance.volume war nicht gültig.
not-allowed: Der Start der Operation war nicht erlaubt.

Rückgabewert

Ein neues SpeechSynthesisErrorEvent Objekt.

Spezifikationen

Specification
Web Speech API # dom-speechsynthesiserrorevent-speechsynthesiserrorevent

Browser-Kompatibilität

Siehe auch

SpeechSynthesisEvent