Back to Content

SpeechRecognitionResult: length property

files/en-us/web/api/speechrecognitionresult/length/index.md

latest1.0 KB
Original Source

{{APIRef("Web Speech API")}}

The length read-only property of the {{domxref("SpeechRecognitionResult")}} interface returns the length of the "array" — the number of {{domxref("SpeechRecognitionAlternative")}} objects contained in the result (also referred to as "n-best alternatives".)

The number of alternatives contained in the result depends on what the {{domxref("SpeechRecognition.maxAlternatives")}} property was set to when the speech recognition was first initiated.

Value

A number.

Examples

This code is excerpted from our Speech color changer example.

js
recognition.onresult = (event) => {
  const color = event.results[0][0].transcript;
  diagnostic.textContent = `Result received: ${color}.`;
  bg.style.backgroundColor = color;

  console.log(event.results[0].length);
};

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}

See also