SpeechRecognitionResultList: item() method
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
The item
getter of the
SpeechRecognitionResultList
interface is a standard getter — it allows
SpeechRecognitionResult
objects in the list to be accessed via array
syntax.
Syntax
js
item(index)
Parameters
index
-
Index of the item to retrieve.
Return value
A SpeechRecognitionResult
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-speechrecognitionresultlist-item |
Browser compatibility
BCD tables only load in the browser