SpeechRecognitionEvent: results property
The results
read-only property of the
SpeechRecognitionEvent
interface returns a
SpeechRecognitionResultList
object representing all the speech
recognition results for the current session.
Specifically this object will contain all final results that have been returned,
followed by the current best hypothesis for all interim results. When subsequent
result
events are fired, interim results may be overwritten by a newer
interim result or by a final result — they may even be removed, if they are at the end
of the "results" array and the array length decreases. Final results on the other hand
will not be overwritten or removed.
Value
A SpeechRecognitionResultList
object.
Examples
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;
};
Specifications
Specification |
---|
Web Speech API # dom-speechrecognitionevent-results |
Browser compatibility
BCD tables only load in the browser