SpeechSynthesisUtterance: voice property
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2018.
The voice
property of the SpeechSynthesisUtterance
interface gets and sets the voice that will be used to speak the utterance.
This should be set to one of the SpeechSynthesisVoice
objects returned by SpeechSynthesis.getVoices()
.
If not set by the time the utterance is spoken, the voice used will be the most suitable default voice available for the utterance's lang
setting.
Value
A SpeechSynthesisVoice
object.
Examples
js
const synth = window.speechSynthesis;
const inputForm = document.querySelector("form");
const inputTxt = document.querySelector("input");
const voiceSelect = document.querySelector("select");
const voices = synth.getVoices();
// ...
inputForm.onsubmit = (event) => {
event.preventDefault();
const utterThis = new SpeechSynthesisUtterance(inputTxt.value);
const selectedOption =
voiceSelect.selectedOptions[0].getAttribute("data-name");
for (let i = 0; i < voices.length; i++) {
if (voices[i].name === selectedOption) {
utterThis.voice = voices[i];
}
}
synth.speak(utterThis);
inputTxt.blur();
};
Specifications
Specification |
---|
Web Speech API # dom-speechsynthesisutterance-voice |
Browser compatibility
Report problems with this compatibility data on GitHubdesktop | mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
voice |
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support
- No support
- No support
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.