Web/API/SpeechSynthesis/voiceschanged event

This is an experimental technologyCheck the Browser compatibility table carefully before using this in production.

The voiceschanged event of the Web Speech API is fired when the list of SpeechSynthesisVoice objects that would be returned by the SpeechSynthesis.getVoices() method has changed (when the voiceschanged event fires.)

Bubbles	No
Cancelable	No
Interface	Event
Event handler property	onvoiceschanged

Examples

This could be used to repopulate a list of voices that the user can choose between when the event fires. You can use the voiceschanged event in an addEventListener method:

var synth = window.speechSynthesis;

synth.addEventListener('voiceschanged', function() {
  var voices = synth.getVoices();
  for(i = 0; i < voices.length ; i++) {
    var option = document.createElement('option');
    option.textContent = voices[i].name + ' (' + voices[i].lang + ')';
    option.setAttribute('data-lang', voices[i].lang);
    option.setAttribute('data-name', voices[i].name);
    voiceSelect.appendChild(option);
  }
});

Or use the onvoiceschanged event handler property:

synth.onvoiceschanged = function() {
  var voices = synth.getVoices();
  for(i = 0; i < voices.length ; i++) {
    var option = document.createElement('option');
    option.textContent = voices[i].name + ' (' + voices[i].lang + ')';
    option.setAttribute('data-lang', voices[i].lang);
    option.setAttribute('data-name', voices[i].name);
    voiceSelect.appendChild(option);
  }
}

Specifications

Specification	Status	Comment
Web Speech APIThe definition of 'speech synthesis events' in that specification.	Draft

Browser compatibility

The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.

Update compatibility data on GitHub

	Desktop						Mobile
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
voiceschanged event Experimental'	Chrome Full support 33	Edge Full support 14	Firefox Full support 49	IE No support No	Opera Full support 21	Safari Full support 7	WebView Android Full support 4.4.3	Chrome Android Full support 33	Firefox Android Full support 62 Full support 62 No support 61 — 62 Disabled' Disabled' From version 61 until version 62 (exclusive): this feature is behind the media.webspeech.synth.enabled preference (needs to be set to true). To change preferences in Firefox, visit about:config.	Opera Android No support No	Safari iOS Full support 7	Samsung Internet Android Full support 3.0

Legend

Full support  

Full support

No support  

No support

Experimental. Expect behavior to change in the future.'

Experimental. Expect behavior to change in the future.

User must explicitly enable this feature.'

User must explicitly enable this feature.

See also

• Web Speech API

SpeechSynthesis: voiceschanged event by Mozilla Contributors is licensed under CC-BY-SA 2.5.