The SpeechRecognitionResult
interface of the Web Speech API represents a single recognition match, which may contain multiple SpeechRecognitionAlternative
objects.
The SpeechRecognitionResult
interface of the Web Speech API represents a single recognition match, which may contain multiple SpeechRecognitionAlternative
objects.
SpeechRecognitionResult.isFinal
Read only
A boolean value that states whether this result is final (true) or not (false) — if so, then this is the final time this result will be returned; if not, then this result is an interim result, and may be updated later on.
SpeechRecognitionResult.length
Read only
Returns the length of the "array" — the number of SpeechRecognitionAlternative
objects contained in the result (also referred to as "n-best alternatives".)
SpeechRecognitionResult.item
A standard getter that allows SpeechRecognitionAlternative
objects within the result to be accessed via array syntax.
This code is excerpted from our Speech color changer example.
js
recognition.onresult = (event) => { // The SpeechRecognitionEvent results property returns a SpeechRecognitionResultList object // The SpeechRecognitionResultList object contains SpeechRecognitionResult objects. // It has a getter so it can be accessed like an array // The first [0] returns the SpeechRecognitionResult at position 0. // Each SpeechRecognitionResult object contains SpeechRecognitionAlternative objects // that contain individual results. // These also have getters so they can be accessed like arrays. // The second [0] returns the SpeechRecognitionAlternative at position 0. // We then return the transcript property of the SpeechRecognitionAlternative object const color = event.results[0][0].transcript; diagnostic.textContent = `Result received: ${color}.`; bg.style.backgroundColor = color; };
Specification |
---|
Web Speech API # speechreco-result |
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | |
SpeechRecognitionResult |
33 | 79 | No | No | No | 14.1 | 4.4.3 | 33 | No | No | 14.5 | 2.0 |
isFinal |
33 | 79 | No | No | No | 14.1 | 4.4.3 | 33 | No | No | 14.5 | 2.0 |
item |
33 | 79 | No | No | No | 14.1 | 4.4.3 | 33 | No | No | 14.5 | 2.0 |
length |
33 | 79 | No | No | No | 14.1 | 4.4.3 | 33 | No | No | 14.5 | 2.0 |
© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/SpeechRecognitionResult