SpeechSynthesisUtterance.SpeechSynthesisUtterance()

This is an experimental technology
Because this technology's specification has not stabilized, check the compatibility table for the proper prefixes to use in various browsers. Also note that the syntax and behavior of an experimental technology is subject to change in future versions of browsers as the spec changes.

The SpeechSynthesisUtterance() constructor of the SpeechSynthesisUtterance interface returns a new SpeechSynthesisUtterance object instance.

Syntax

var utterThis = new SpeechSynthesisUtterance(text);

Parameters

text: A DOMString containing the text that will be synthesised when the utterance is spoken..

Examples

The following snippet is excerpted from our Speech synthesiser demo.

var synth = window.speechSynthesis;

var inputForm = document.querySelector('form');
var inputTxt = document.querySelector('input');
var voiceSelect = document.querySelector('select');

var voices = synth.getVoices();

  ...

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	Status	Comment
Web Speech API The definition of 'SpeechSynthesisUtterance()' in that specification.	Draft

Feature	Chrome	Firefox (Gecko)	Internet Explorer	Opera	Safari (WebKit)
Basic support	33	44 (44) ^[1]	Not supported	Not supported	Not supported

Feature	Android	Chrome	Firefox Mobile (Gecko)	Firefox OS	IE Phone	Opera Mobile	Safari Mobile
Basic support	?	(Yes)	?	2.5	Not supported	Not supported	Not supported

[1] Can be enabled via the media.webspeech.synth.enabled flag in about:config.

SpeechSynthesisUtterance.SpeechSynthesisUtterance()

Syntax

Parameters

Examples

Specifications

Browser compatibility

See also

Document Tags and Contributors