SpeechSynthesisUtterance: mark-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 mark-Ereignis des SpeechSynthesisUtterance-Objekts der Web Speech API wird ausgelöst, wenn der gesprochene Ausdruck ein benanntes SSML-"mark"-Tag erreicht.

Syntax

Verwenden Sie den Ereignisnamen in Methoden wie addEventListener() oder setzen Sie eine Ereignisbehandlereigenschaft.

js
addEventListener("mark", (event) => {});

onmark = (event) => {};

Ereignistyp

Ereigniseigenschaften

Neben den unten aufgeführten Eigenschaften sind Eigenschaften aus der Elternschnittstelle 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 nach Beginn des Sprechvorgangs von SpeechSynthesisUtterance.text zurück, zu der das Ereignis ausgelöst wurde.

name Schreibgeschützt

Gibt den Namen zurück, der mit bestimmten Arten von Ereignissen verknüpft ist, die auftreten, während SpeechSynthesisUtterance.text gesprochen wird: der Name des SSML-Markers, der im Falle eines mark-Ereignisses erreicht wurde, oder der Typ der erreichten Grenze im Falle eines boundary-Ereignisses.

utterance Schreibgeschützt

Gibt die SpeechSynthesisUtterance-Instanz zurück, bei der das Ereignis ausgelöst wurde.

Beispiele

Sie können das mark-Ereignis in einer addEventListener-Methode verwenden:

js
utterThis.addEventListener("mark", (event) => {
  console.log(`A mark was reached: ${event.name}`);
});

Oder die onmark-Ereignisbehandlereigenschaft verwenden:

js
utterThis.onmark = (event) => {
  console.log(`A mark was reached: ${event.name}`);
};

Spezifikationen

Specification
Web Speech API
# eventdef-speechsynthesisutterance-mark
Web Speech API
# dom-speechsynthesisutterance-onmark

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch