Replace SpeechRecognitionPhraseList with sequence<SpeechRecognitionPhrase>

evliu-google · evliu-google · commit 2de635f812c2 · 2025-06-23T16:31:35.000-07:00
diff --git a/index.bs b/index.bs
@@ -163,7 +163,7 @@ The term "interim result" indicates a {{SpeechRecognitionResult}} in which the {
 <dl dfn-type=attribute dfn-for="SpeechRecognition">
     : <dfn>[[phrases]]</dfn>
     ::
-        A {{SpeechRecognitionPhraseList}} representing a list of phrases for contextual biasing. The initial value is null.
+        A sequence of {{SpeechRecognitionPhrase}} representing a list of phrases for contextual biasing. The initial value is an empty sequence.
 </dl>
 
 <xmp class="idl">
@@ -178,7 +178,7 @@ interface SpeechRecognition : EventTarget {
     attribute boolean interimResults;
     attribute unsigned long maxAlternatives;
     attribute boolean processLocally;
-    attribute SpeechRecognitionPhraseList phrases;
+    attribute sequence<SpeechRecognitionPhrase> phrases;
 
     // methods to drive the speech interaction
     undefined start();
@@ -298,16 +298,6 @@ interface SpeechRecognitionPhrase {
     readonly attribute DOMString phrase;
     readonly attribute float boost;
 };
-
-// The object representing a list of phrases for contextual biasing.
-[SecureContext, Exposed=Window]
-interface SpeechRecognitionPhraseList {
-    constructor(sequence<SpeechRecognitionPhrase> phrases);
-    readonly attribute unsigned long length;
-    SpeechRecognitionPhrase item(unsigned long index);
-    undefined addItem(SpeechRecognitionPhrase item);
-    undefined removeItem(unsigned long index);
-};
 </xmp>
 
 <h4 id="speechreco-attributes">SpeechRecognition Attributes</h4>
@@ -354,7 +344,7 @@ interface SpeechRecognitionPhraseList {
   </dd>
   <dd>
     The setter steps are:
-    1. If the {{SpeechRecognitionPhraseList/length}} of the given value is greater than 0 and the system does not support contextual biasing,
+    1. If the size of the given value is greater than 0 and the system does not support contextual biasing,
         throw a {{SpeechRecognitionErrorEvent}} with the {{phrases-not-supported}} error code and abort these steps.
     1. Set {{SpeechRecognition/[[phrases]]}} to the given value.
     1. Send a copy of {{SpeechRecognition/[[phrases]]}} to the system for initializing or updating the phrases for contextual biasing implementation.
@@ -727,59 +717,6 @@ For a non-continuous recognition it will hold only a single value.</p>
   <dd>This attribute returns the value of {{[[boost]]}}.</dd>
 </dl>
 
-<h4 id="speechreco-phraselist">SpeechRecognitionPhraseList</h4>
-
-<p>The SpeechRecognitionPhraseList object holds a list of phrases for contextual biasing and has the following internal slot:</p>
-
-<dl dfn-type=attribute dfn-for="SpeechRecognitionPhraseList">
-    : <dfn>[[phrases]]</dfn>
-    ::
-        A list of {{SpeechRecognitionPhrase}} representing the phrases to be boosted. The initial value is an empty list.
-</dl>
-
-<dl>
-  <dt><dfn constructor for=SpeechRecognitionPhraseList>SpeechRecognitionPhraseList(|phrases|)</dfn> constructor</dt>
-  <dd>
-    When this constructor is invoked, run the following steps:
-    1. Let |list| be a new object of type {{SpeechRecognitionPhraseList}}.
-    1. Set |list|.{{SpeechRecognitionPhraseList/[[phrases]]}} to be the value of |phrases|.
-    1. Return |list|.
-  </dd>
-
-  <dt><dfn attribute for=SpeechRecognitionPhraseList>length</dfn> attribute</dt>
-  <dd>
-    This attribute indicates the number of phrases in the list.
-    When invoked, return the number of items in {{SpeechRecognitionPhraseList/[[phrases]]}}.
-  </dd>
-
-  <dt><dfn method for=SpeechRecognitionPhraseList>item(|index|)</dfn> method</dt>
-  <dd>
-    This method gets the {{SpeechRecognitionPhrase}} object at the |index| of the list.
-    When invoked, run the following steps:
-    1. If |index| is smaller than 0, or greater than or equal to {{SpeechRecognitionPhraseList/length}},
-        throw a {{RangeError}} and abort these steps.
-    1. Return the {{SpeechRecognitionPhrase}} at the |index| of {{SpeechRecognitionPhraseList/[[phrases]]}}.
-  </dd>
-
-  <dt><dfn method for=SpeechRecognitionPhraseList>addItem(|item|)</dfn> method</dt>
-  <dd>
-    This method adds the {{SpeechRecognitionPhrase}} object |item| to the list.
-    When invoked, add |item| to the end of {{SpeechRecognitionPhraseList/[[phrases]]}}.
-    The list is allowed to have multiple {{SpeechRecognitionPhrase}} objects with the same {{SpeechRecognitionPhrase/[[phrase]]}} value,
-    and the speech recognition model should use the last {{SpeechRecognitionPhrase/[[boost]]}} value
-    for this {{SpeechRecognitionPhrase/[[phrase]]}} in the list.
-  </dd>
-
-  <dt><dfn method for=SpeechRecognitionPhraseList>removeItem(|index|)</dfn> method</dt>
-  <dd>
-    This method removes the {{SpeechRecognitionPhrase}} object at the |index| of the list.
-    When invoked, run the following steps:
-    1. If |index| is smaller than 0, or greater than or equal to {{SpeechRecognitionPhraseList/length}},
-        throw a {{RangeError}} and abort these steps.
-    1. Remove the {{SpeechRecognitionPhrase}} object at the |index| of {{SpeechRecognitionPhraseList/[[phrases]]}}.
-  </dd>
-</dl>
-
 <h4 id="speechreco-speechgrammar">SpeechGrammar</h4>
 
 <p>The SpeechGrammar object represents a container for a grammar.</p>
