-
Notifications
You must be signed in to change notification settings - Fork 22.4k
/
index.md
61 lines (45 loc) · 1.95 KB
/
index.md
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
---
title: "SpeechGrammarList: addFromString() method"
short-title: addFromString()
slug: Web/API/SpeechGrammarList/addFromString
page-type: web-api-instance-method
status:
- experimental
browser-compat: api.SpeechGrammarList.addFromString
---
{{APIRef("Web Speech API")}}{{ SeeCompatTable() }}
The **`addFromString()`** method of the
{{domxref("SpeechGrammarList")}} interface takes a grammar present in a specific
string within the code base (e.g. stored in a variable) and adds it to
the `SpeechGrammarList` as a new {{domxref("SpeechGrammar")}} object.
## Syntax
```js-nolint
addFromString(string)
addFromString(string, weight)
```
### Parameters
- `string`
- : A string representing the grammar to be added.
- `weight` {{optional_inline}}
- : A float representing the weight of the grammar relative to other grammars present in
the {{domxref("SpeechGrammarList")}}. The weight means the importance of this grammar,
or the likelihood that it will be recognized by the speech recognition service. The
value can be between `0.0` and `1.0`; If not specified, the
default used is `1.0`.
### Return value
None ({{jsxref("undefined")}}).
## Examples
```js
const 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 ;";
const recognition = new SpeechRecognition();
const speechRecognitionList = new SpeechGrammarList();
speechRecognitionList.addFromString(grammar, 1);
recognition.grammars = speechRecognitionList;
```
## Specifications
{{Specifications}}
## Browser compatibility
{{Compat}}
## See also
- [Web Speech API](/en-US/docs/Web/API/Web_Speech_API)