This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The addFromString()
method of the SpeechGrammarList
interface takes a grammar present in a specific DOMString
within the code base (e.g. stored in a variable) and adds it to the SpeechGrammarList
as a new SpeechGrammar
object.
Syntax
speechGrammarListInstance.addFromString(string,weight);
Returns
Void.
Parameters
- string
- A
DOMString
representing the grammar to be added. - weight Optional
- A float representing the weight of the grammar relative to other grammars present in the
SpeechGrammarList
. The weight means the importance of this grammar, or the likelihood that it will be recognised by the speech recognition service. The value can be between0.0
and1.0
; If not specified, the default used is1.0
.
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;
Specifications
Specification | Status | Comment |
---|---|---|
Web Speech API The definition of 'addFromString()' in that specification. |
Draft |
Browser compatibility
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
addFromString | Chrome
Full support
33
| Edge
Full support
≤79
| Firefox No support No | IE No support No | Opera No support No | Safari No support No | WebView Android
Full support
Yes
| Chrome Android
Full support
Yes
| Firefox Android No support No | Opera Android No support No | Safari iOS No support No | Samsung Internet Android
Full support
Yes
|
Legend
- Full support
- Full support
- No support
- No support
- Experimental. Expect behavior to change in the future.
- Experimental. Expect behavior to change in the future.
- See implementation notes.
- See implementation notes.
- Requires a vendor prefix or different name for use.
- Requires a vendor prefix or different name for use.