SpeechRecognitionEvent: results-Eigenschaft

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Die results-Eigenschaft der SpeechRecognitionEvent-Schnittstelle ist eine schreibgeschützte Eigenschaft, die ein SpeechRecognitionResultList-Objekt zurückgibt, das alle Spracherkennungsergebnisse für die aktuelle Sitzung darstellt.

Speziell enthält dieses Objekt alle finalen Ergebnisse, die zurückgegeben wurden, gefolgt von der aktuellen besten Hypothese für alle vorläufigen Ergebnisse. Wenn nachfolgende result-Ereignisse ausgelöst werden, können vorläufige Ergebnisse durch ein neueres vorläufiges Ergebnis oder durch ein finales Ergebnis überschrieben werden – sie können sogar entfernt werden, wenn sie sich am Ende des "results"-Arrays befinden und sich die Array-Länge verkürzt. Finale Ergebnisse hingegen werden nicht überschrieben oder entfernt.

Wert

Beispiele

Dieser Code stammt aus unserem Speech color changer-Beispiel.

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

Spezifikationen

Specification
Web Speech API
# dom-speechrecognitionevent-results

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
results

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support

Siehe auch