SpeechRecognitionErrorEvent: error property

Limited availability

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

The error read-only property of the SpeechRecognitionErrorEvent interface returns the type of error raised.

Value

An enumerated value representing the type of error. The possible error types are:

aborted: Speech input was aborted in some manner, perhaps by some user-agent-specific behavior like a button the user can press to cancel speech input.
audio-capture: Audio capture failed.
bad-grammar Deprecated Non-standard: There was an error in the speech recognition grammar or semantic tags, or the chosen grammar format or semantic tag format was unsupported.

Note: This error is no longer in the Web Speech API specification; the whole concept of grammar has been removed. Related features have been kept in the specification and are still recognized by supporting browsers for backwards compatibility purposes, but they have no effect on speech recognition services.
language-not-supported: The user agent does not support the language specified in the value of lang attribute of the SpeechRecognition object. The set of supported languages is browser-dependent, and from frontend code there is no way to programmatically determine what languages a user's browser supports for speech recognition.
network: Network communication required for completing the recognition failed.
no-speech: No speech was detected.
not-allowed: The user agent disallowed any speech input from occurring for reasons of security, privacy or user preference.
phrases-not-supported: The speech recognition model does not support phrases for contextual biasing.
service-not-allowed: The user agent disallowed the requested speech recognition service, either because the user agent doesn't support it or because of reasons of security, privacy or user preference. In this case it would allow another more suitable speech recognition service to be used instead.

Examples

const recognition = new SpeechRecognition();

recognition.onerror = (event) => {
  console.log(`Speech recognition error detected: ${event.error}`);
  console.log(`Additional information: ${event.message}`);
};