SpeechSynthesis.speak()

Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.

The speak() method of the SpeechSynthesis interface adds an utterance to the utterance queue; it will be spoken when any other utterances queued before it have been spoken.

Syntax

speechSynthesisInstance.speak(utterance);

Returns

Void.

Parameters

utterance

A SpeechSynthesisUtterance object.

Examples

This snippet is excerpted from our Speech synthesiser demo. When a form containing the text we want to speak is submitted, we (amongst other things) create a new utterance containing this text, then speak it by passing it into speak() as a parameter.

var synth = window.speechSynthesis;

  ...

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

  var utterThis = new SpeechSynthesisUtterance(inputTxt.value);
  var selectedOption = voiceSelect.selectedOptions[0].getAttribute('data-name');
  for(i = 0; i < voices.length ; i++) {
    if(voices[i].name === selectedOption) {
      utterThis.voice = voices[i];
    }
  }
  synth.speak(utterThis);
  inputTxt.blur();
}

Specifications

Specification
Web Speech API
# dom-speechsynthesis-speak

Browser compatibility

BCD tables only load in the browser

See also