voiceschanged

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.)

Examples

This could be used to repopulate a list of voices that the user can choose between when the event fires:

var synth = window.speechSynthesis;

  ...

synth.onvoicechanged = 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);
  }
}

Inheritance

The voicechanged event implements the Event interface — it has available the properties and methods defined on this interface.

Specifications

Browser compatibility

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

See also

• Web Speech API