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

Syntax

Verwenden Sie den Ereignisnamen in Methoden wie addEventListener(), oder setzen Sie eine Ereignishandler-Eigenschaft.

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

onmark = (event) => { }

Ereignistyp

Ereigniseigenschaften

Zusätzlich zu den unten aufgeführten Eigenschaften sind die Eigenschaften 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 zurück, nachdem das SpeechSynthesisUtterance.text zu sprechen begonnen wurde, als das Ereignis ausgelöst wurde.

name Schreibgeschützt

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

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-Ereignishandlereigenschaft 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

Siehe auch