SpeechRecognitionResultList
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The SpeechRecognitionResultList
interface of the Web Speech API represents a list of SpeechRecognitionResult
objects, or a single one if results are being captured in continuous
mode.
Properties
SpeechRecognitionResultList.length
Read only-
Returns the length of the "array" — the number of
SpeechRecognitionResult
objects in the list.
Methods
SpeechRecognitionResultList.item
-
A standard getter that allows
SpeechRecognitionResult
objects in the list 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 |
---|
Web Speech API # speechreco-resultlist |
Browser compatibility
Report problems with this compatibility data on GitHubdesktop | mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
SpeechRecognitionResultList | ChromeFull support33 | EdgeFull support79 | FirefoxNo supportNo | Internet ExplorerNo supportNo | OperaNo supportNo | SafariFull support14.1 | WebView AndroidFull support4.4.3 | Chrome AndroidFull support33 | Firefox for AndroidNo supportNo | Opera AndroidNo supportNo | Safari on iOSFull support14.5 | Samsung InternetFull support2.0 |
item | ChromeFull support33 | EdgeFull support79 | FirefoxNo supportNo | Internet ExplorerNo supportNo | OperaNo supportNo | SafariFull support14.1 | WebView AndroidFull support4.4.3 | Chrome AndroidFull support33 | Firefox for AndroidNo supportNo | Opera AndroidNo supportNo | Safari on iOSFull support14.5 | Samsung InternetFull support2.0 |
length | ChromeFull support33 | EdgeFull support79 | FirefoxNo supportNo | Internet ExplorerNo supportNo | OperaNo supportNo | SafariFull support14.1 | WebView AndroidFull support4.4.3 | Chrome AndroidFull support33 | Firefox for AndroidNo supportNo | Opera AndroidNo supportNo | Safari on iOSFull support14.5 | Samsung InternetFull support2.0 |
Legend
- Full support
- Full support
- No support
- No support
- Experimental. Expect behavior to change in the future.
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.