SpeechSynthesis: voiceschanged event

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2022.

See full compatibility

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

Syntax

Use the event name in methods like addEventListener(), or set an event handler property.

addEventListener("voiceschanged", (event) => { })

onvoiceschanged = (event) => { }

Event type

A generic Event with no added properties.

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:

const synth = window.speechSynthesis;

synth.addEventListener("voiceschanged", () => {
  const voices = synth.getVoices();
  for (const voice of voices) {
    const option = document.createElement("option");
    option.textContent = `${voice.name} (${voice.lang})`;
    option.setAttribute("data-lang", voice.lang);
    option.setAttribute("data-name", voice.name);
    voiceSelect.appendChild(option);
  }
});

Or use the onvoiceschanged event handler property:

const synth = window.speechSynthesis;
synth.onvoiceschanged = () => {
  const voices = synth.getVoices();
  for (const voice of voices) {
    const option = document.createElement("option");
    option.textContent = `${voice.name} (${voice.lang})`;
    option.setAttribute("data-lang", voice.lang);
    option.setAttribute("data-name", voice.name);
    voiceSelect.appendChild(option);
  }
};

Specifications

Specification
Web Speech API # eventdef-speechsynthesis-voiceschanged
Web Speech API # dom-speechsynthesis-onvoiceschanged

Browser compatibility

	desktop					mobile
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox for Android	Opera Android	Safari on iOS	Samsung Internet	WebView Android	WebView on iOS
`voiceschanged` event	Chrome – Full support Chrome 33 (Release date: 2014-02-20) footnote Full support	Edge – Full support Edge 14 (Release date: 2016-08-02) footnote Full support	Firefox – Full support Firefox 49 (Release date: 2016-09-20) footnote Full support	Opera – Full support Opera 21 (Release date: 2014-05-06) footnote Full support	Safari – Full support Safari 16 (Release date: 2022-09-12) footnote Full support	Chrome Android – Full support Chrome Android 33 (Release date: 2014-02-26) footnote Full support	Firefox for Android – Full support Firefox for Android 62 (Release date: 2018-09-05) footnote Full support	Opera Android – No support Opera Android footnote No support	Safari on iOS – Full support Safari on iOS 16 (Release date: 2022-09-12) footnote Full support	Samsung Internet – Full support Samsung Internet 3 (Release date: 2015-04-10) footnote Full support	WebView Android – No support WebView Android footnote No support	WebView on iOS – Full support WebView on iOS 16 (Release date: 2022-09-12) footnote Full support

Tip: you can click/tap on a cell for more information.

Full support: Full support
No support: No support