W3cubDocs

/DOM

SpeechGrammar

This is an experimental technology
Check the Browser compatibility table carefully before using this in production.

The SpeechGrammar interface of the Web Speech API represents a set of words or patterns of words that we want the recognition service to recognize.

Grammar is defined using JSpeech Grammar Format (JSGF.) Other formats may also be supported in the future.

Constructor

SpeechGrammar.SpeechGrammar(): Creates a new SpeechGrammar object.

Properties

SpeechGrammar.src: Sets and returns a string containing the grammar from within in the SpeechGrammar object instance.
SpeechGrammar.weight Optional: Sets and returns the weight of the SpeechGrammar object.

Examples

var grammar = '#JSGF V1.0; grammar colors; public <color> = aqua | azure | beige | bisque | black | blue | brown | chocolate | coral | crimson | cyan | fuchsia | ghostwhite | gold | goldenrod | gray | green | indigo | ivory | khaki | lavender | lime | linen | magenta | maroon | moccasin | navy | olive | orange | orchid | peru | pink | plum | purple | red | salmon | sienna | silver | snow | tan | teal | thistle | tomato | turquoise | violet | white | yellow ;'
var recognition = new SpeechRecognition();
var speechRecognitionList = new SpeechGrammarList();
speechRecognitionList.addFromString(grammar, 1);
recognition.grammars = speechRecognitionList;


console.log(speechRecognitionList[0].src); // should return the same as the contents of the grammar variable
console.log(speechRecognitionList[0].weight); // should return 1 - the same as the weight set in line 4.

Specifications

Specification	Status	Comment
Web Speech API The definition of 'SpeechGrammar' in that specification.	Draft

Browser compatibilityUpdate compatibility data on GitHub

	Desktop
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari
Basic support	25 Prefixed 25 Prefixed Prefixed Requires the vendor prefix: webkit	No	44 Disabled 44 Disabled Note that currently only the speech synthesis part is available in Firefox Desktop — the speech recognition part will be available soon, once the required internal permissions are sorted out. Disabled From version 44: this feature is behind the `media.webspeech.recognition.enable` preference (needs to be set to `true`). To change preferences in Firefox, visit about:config.	No	27	No
`SpeechGrammar()` constructor	25 Prefixed 25 Prefixed Prefixed Requires the vendor prefix: webkit	No	44 Disabled 44 Disabled Note that currently only the speech synthesis part is available in Firefox Desktop — the speech recognition part will be available soon, once the required internal permissions are sorted out. Disabled From version 44: this feature is behind the `media.webspeech.recognition.enable` preference (needs to be set to `true`). To change preferences in Firefox, visit about:config.	No	27	No
`src`	25	No	44 Disabled 44 Disabled Note that currently only the speech synthesis part is available in Firefox Desktop — the speech recognition part will be available soon, once the required internal permissions are sorted out. Disabled From version 44: this feature is behind the `media.webspeech.recognition.enable` preference (needs to be set to `true`). To change preferences in Firefox, visit about:config.	No	27	No
`weight`	25	No	44 Disabled 44 Disabled Note that currently only the speech synthesis part is available in Firefox Desktop — the speech recognition part will be available soon, once the required internal permissions are sorted out. Disabled From version 44: this feature is behind the `media.webspeech.recognition.enable` preference (needs to be set to `true`). To change preferences in Firefox, visit about:config.	No	27	No

	Mobile
	Android webview	Chrome for Android	Edge Mobile	Firefox for Android	Opera for Android	iOS Safari	Samsung Internet
Basic support	No	64 Prefixed 64 Prefixed Prefixed Requires the vendor prefix: webkit	No	No	No	No	No
`SpeechGrammar()` constructor	No	64 Prefixed 64 Prefixed Prefixed Requires the vendor prefix: webkit	No	No	No	No	No
`src`	No	64	No	No	No	No	No
`weight`	No	64	No	No	No	No	No

SpeechGrammar

Constructor

Properties

Examples

Specifications

Browser compatibilityUpdate compatibility data on GitHub

See also