This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The getVoices()
method of the SpeechSynthesis
interface returns a list of SpeechSynthesisVoice
objects representing all the available voices on the current device.
Syntax
speechSynthesisInstance.getVoices();
Parameters
None.
Return value
A list (array) of SpeechSynthesisVoice
objects.
Note: The spec wrongly lists this method as returning as a SpeechSynthesisVoiceList
object, but this was in fact removed from the spec.
Example
JavaScript
function populateVoiceList() { if(typeof speechSynthesis === 'undefined') { return; } var voices = speechSynthesis.getVoices(); for(var i = 0; i < voices.length; i++) { var option = document.createElement('option'); option.textContent = voices[i].name + ' (' + voices[i].lang + ')'; if(voices[i].default) { option.textContent += ' -- DEFAULT'; } option.setAttribute('data-lang', voices[i].lang); option.setAttribute('data-name', voices[i].name); document.getElementById("voiceSelect").appendChild(option); } } populateVoiceList(); if (typeof speechSynthesis !== 'undefined' && speechSynthesis.onvoiceschanged !== undefined) { speechSynthesis.onvoiceschanged = populateVoiceList; }
HTML
<select id="voiceSelect"></select>
Specifications
Specification | Status | Comment |
---|---|---|
Web Speech API The definition of 'getVoices()' in that specification. |
Draft | Initial definition |
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.
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
getVoices | 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
| 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.