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.

SyntaxEdit

var utterThis = new SpeechSynthesisUtterance(text);

Parameters

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

ExamplesEdit

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();
}

SpecificationsEdit

Specification Status Comment
Web Speech API
The definition of 'SpeechSynthesisUtterance()' in that specification.
Draft  

Browser compatibilityEdit

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
Basic support 33 44 (44) [1] Not supported Not supported Not supported
  • [1] Can be enabled via the media.webspeech.synth.enabled flag in about:config.

See alsoEdit

Document Tags and Contributors

 Contributors to this page: chrisdavidmills
 Last updated by: chrisdavidmills,