SpeechRecognitionResult

This is an experimental technology
Check the Browser compatibility table carefully before using this in production.

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

Properties

SpeechRecognitionResult.isFinal Read only
A Boolean 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".)

Methods

SpeechRecognitionResult.item
A standard getter that allows SpeechRecognitionAlternative objects within the result to be accessed via array syntax.

Examples

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;
}

Specifications

Specification Status Comment
Web Speech API
The definition of 'SpeechRecognitionResult' in that specification.
Draft

Browser compatibility

DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidFirefox for AndroidOpera for AndroidSafari on iOSSamsung Internet
SpeechRecognitionResult
Experimental
Chrome Full support 33
Prefixed Notes
Full support 33
Prefixed Notes
Prefixed Implemented with the vendor prefix: webkit
Notes You'll need to serve your code through a web server for recognition to work.
Edge Full support ≤79
Prefixed Notes
Full support ≤79
Prefixed Notes
Prefixed Implemented with the vendor prefix: webkit
Notes You'll need to serve your code through a web server for recognition to work.
Firefox No support NoIE No support NoOpera No support NoSafari No support NoWebView Android Full support Yes
Prefixed Notes
Full support Yes
Prefixed Notes
Prefixed Implemented with the vendor prefix: webkit
Notes You'll need to serve your code through a web server for recognition to work.
Chrome Android Full support Yes
Prefixed Notes
Full support Yes
Prefixed Notes
Prefixed Implemented with the vendor prefix: webkit
Notes You'll need to serve your code through a web server for recognition to work.
Firefox Android No support NoOpera Android No support NoSafari iOS No support NoSamsung Internet Android Full support Yes
Prefixed Notes
Full support Yes
Prefixed Notes
Prefixed Implemented with the vendor prefix: webkit
Notes You'll need to serve your code through a web server for recognition to work.
isFinal
Experimental
Chrome Full support 33
Prefixed Notes
Full support 33
Prefixed Notes
Prefixed Implemented with the vendor prefix: webkit
Notes You'll need to serve your code through a web server for recognition to work.
Edge Full support ≤79
Prefixed Notes
Full support ≤79
Prefixed Notes
Prefixed Implemented with the vendor prefix: webkit
Notes You'll need to serve your code through a web server for recognition to work.
Firefox No support NoIE No support NoOpera No support NoSafari No support NoWebView Android Full support Yes
Prefixed Notes
Full support Yes
Prefixed Notes
Prefixed Implemented with the vendor prefix: webkit
Notes You'll need to serve your code through a web server for recognition to work.
Chrome Android Full support Yes
Prefixed Notes
Full support Yes
Prefixed Notes
Prefixed Implemented with the vendor prefix: webkit
Notes You'll need to serve your code through a web server for recognition to work.
Firefox Android No support NoOpera Android No support NoSafari iOS No support NoSamsung Internet Android Full support Yes
Prefixed Notes
Full support Yes
Prefixed Notes
Prefixed Implemented with the vendor prefix: webkit
Notes You'll need to serve your code through a web server for recognition to work.
item
Experimental
Chrome Full support 33
Prefixed Notes
Full support 33
Prefixed Notes
Prefixed Implemented with the vendor prefix: webkit
Notes You'll need to serve your code through a web server for recognition to work.
Edge Full support ≤79
Prefixed Notes
Full support ≤79
Prefixed Notes
Prefixed Implemented with the vendor prefix: webkit
Notes You'll need to serve your code through a web server for recognition to work.
Firefox No support NoIE No support NoOpera No support NoSafari No support NoWebView Android Full support Yes
Prefixed Notes
Full support Yes
Prefixed Notes
Prefixed Implemented with the vendor prefix: webkit
Notes You'll need to serve your code through a web server for recognition to work.
Chrome Android Full support Yes
Prefixed Notes
Full support Yes
Prefixed Notes
Prefixed Implemented with the vendor prefix: webkit
Notes You'll need to serve your code through a web server for recognition to work.
Firefox Android No support NoOpera Android No support NoSafari iOS No support NoSamsung Internet Android Full support Yes
Prefixed Notes
Full support Yes
Prefixed Notes
Prefixed Implemented with the vendor prefix: webkit
Notes You'll need to serve your code through a web server for recognition to work.
length
Experimental
Chrome Full support 33
Prefixed Notes
Full support 33
Prefixed Notes
Prefixed Implemented with the vendor prefix: webkit
Notes You'll need to serve your code through a web server for recognition to work.
Edge Full support ≤79
Prefixed Notes
Full support ≤79
Prefixed Notes
Prefixed Implemented with the vendor prefix: webkit
Notes You'll need to serve your code through a web server for recognition to work.
Firefox No support NoIE No support NoOpera No support NoSafari No support NoWebView Android Full support Yes
Prefixed Notes
Full support Yes
Prefixed Notes
Prefixed Implemented with the vendor prefix: webkit
Notes You'll need to serve your code through a web server for recognition to work.
Chrome Android Full support Yes
Prefixed Notes
Full support Yes
Prefixed Notes
Prefixed Implemented with the vendor prefix: webkit
Notes You'll need to serve your code through a web server for recognition to work.
Firefox Android No support NoOpera Android No support NoSafari iOS No support NoSamsung Internet Android Full support Yes
Prefixed Notes
Full support Yes
Prefixed Notes
Prefixed Implemented with the vendor prefix: webkit
Notes You'll need to serve your code through a web server for recognition to work.

Legend

Full support
Full support
No support
No support
Experimental. Expect behavior to change in the future.
Experimental. Expect behavior to change in the future.
See implementation notes.
See implementation notes.
Requires a vendor prefix or different name for use.
Requires a vendor prefix or different name for use.

See also