SpeechRecognitionResult

Limited availability

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

Die SpeechRecognitionResult-Schnittstelle der Web Speech API repräsentiert einen einzelnen Erkennungstreffer, der mehrere SpeechRecognitionAlternative-Objekte enthalten kann.

Instanz-Eigenschaften

SpeechRecognitionResult.isFinal Schreibgeschützt

Ein boolescher Wert, der angibt, ob dieses Ergebnis endgültig (true) oder nicht (false) ist — dies ist das letzte Mal, dass dieses Ergebnis zurückgegeben wird; wenn nicht, ist das Ergebnis vorläufig und kann später aktualisiert werden.

SpeechRecognitionResult.length Schreibgeschützt

Gibt die Länge des "Arrays" zurück — die Anzahl der im Ergebnis enthaltenen SpeechRecognitionAlternative-Objekte (auch als "n-best alternatives" bezeichnet).

Instanz-Methoden

SpeechRecognitionResult.item

Ein standardmäßiger Getter, der den Zugriff auf SpeechRecognitionAlternative-Objekte innerhalb des Ergebnisses über Array-Syntax ermöglicht.

Beispiele

Dieser Code ist aus unserem Speech color changer-Beispiel entnommen.

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
# speechreco-result

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
SpeechRecognitionResult
isFinal
item
length

Legend

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

Full support
Full support
No support
No support

Siehe auch