SpeechRecognitionResult
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
The SpeechRecognitionResult interface of the Web Speech API represents a single recognition match, which may contain multiple SpeechRecognitionAlternative objects.
Instance properties
SpeechRecognitionResult.isFinalRead 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.lengthRead only-
Returns the length of the "array" — the number of
SpeechRecognitionAlternativeobjects contained in the result (also referred to as "n-best alternatives".)
Instance methods
SpeechRecognitionResult.item-
A standard getter that allows
SpeechRecognitionAlternativeobjects within the result to be accessed via array syntax.
Examples
This code is excerpted from our Speech color changer example.
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 # speechreco-result |
Browser compatibility
| desktop | mobile | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
SpeechRecognitionResult | ||||||||||||
isFinal | ||||||||||||
item | ||||||||||||
length | ||||||||||||