SpeechSynthesisUtterance: text-Eigenschaft

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.

Die text-Eigenschaft der Schnittstelle SpeechSynthesisUtterance ruft den Text ab oder setzt ihn, der synthetisiert wird, wenn der Ausspruch gesprochen wird.

Der Text kann als reiner Text oder als wohlgeformtes SSML-Dokument bereitgestellt werden. Die SSML-Tags werden von Geräten entfernt, die SSML nicht unterstützen.

Wert

Ein String, der den zu synthetisierenden Text darstellt. Die maximale Länge des Textes, der in jedem Ausspruch gesprochen werden kann, beträgt 32.767 Zeichen.

Beispiele

js
const synth = window.speechSynthesis;

const inputForm = document.querySelector("form");
const inputTxt = document.querySelector("input");
const voiceSelect = document.querySelector("select");

const voices = synth.getVoices();

// …

inputForm.onsubmit = (event) => {
  event.preventDefault();

  const utterThis = new SpeechSynthesisUtterance(inputTxt.value);
  const selectedOption =
    voiceSelect.selectedOptions[0].getAttribute("data-name");
  for (const voice of voices) {
    if (voice.name === selectedOption) {
      utterThis.voice = voice;
    }
  }
  console.log(utterThis.text);
  synth.speak(utterThis);
  inputTxt.blur();
};

Spezifikationen

Specification
Web Speech API
# dom-speechsynthesisutterance-text

Browser-Kompatibilität

Siehe auch