Experimental: 这是一个实验中的功能

The SpeechRecognitionResult interface of the Web Speech API represents a single recognition match, which may contain multiple SpeechRecognitionAlternative (en-US) objects.


SpeechRecognitionResult.isFinal 只读

A Boolean (en-US) 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 (en-US) 只读

Returns the length of the "array" — the number of SpeechRecognitionAlternative (en-US) objects contained in the result (also referred to as "n-best alternatives".)


SpeechRecognitionResult.item (en-US)

A standard getter that allows SpeechRecognitionAlternative (en-US) objects within the result to be accessed via array syntax.


This code is excerpted from our Speech color changer example.

recognition.onresult = function(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
  var color = event.results[0][0].transcript;
  diagnostic.textContent = 'Result received: ' + color + '.';
  bg.style.backgroundColor = color;


Web Speech API
# speechreco-result

Browser compatibility

BCD tables only load in the browser

See also