Use Observale array's backing list

whatwg · Jun 13, 2023 · 9decca2 · 9decca2
1 parent 4df5fdb
commit 9decca2
Showing 1 changed file with 21 additions and 35 deletions.
diff --git a/source b/source
@@ -2802,6 +2802,7 @@ a.setAttribute('href', 'https://example.com/'); // change the content attribute
      <li><dfn data-x-href="https://webidl.spec.whatwg.org/#a-promise-rejected-with">a promise rejected with</dfn></li>
      <li><dfn data-x-href="https://webidl.spec.whatwg.org/#upon-rejection">upon rejection</dfn></li>
      <li><dfn data-x-href="https://webidl.spec.whatwg.org/#upon-fulfillment">upon fulfillment</dfn></li>
+     <li><dfn data-x-href="https://webidl.spec.whatwg.org/#observable-array-attribute-backing-list">backing list</dfn></li>
      <li><dfn data-x="Global" data-x-href="https://webidl.spec.whatwg.org/#Global"><code>[Global]</code></dfn></li>
      <li><dfn data-x="LegacyFactoryFunction" data-x-href="https://webidl.spec.whatwg.org/#LegacyFactoryFunction"><code>[LegacyFactoryFunction]</code></dfn></li>
      <li><dfn data-x="LegacyLenientThis" data-x-href="https://webidl.spec.whatwg.org/#LegacyLenientThis"><code>[LegacyLenientThis]</code></dfn></li>
@@ -89244,11 +89245,12 @@ readonly attribute DOMString? <span data-x="dom-not-restored-reasons-src">src</s
 attribute DOMString? <span data-x="dom-not-restored-reasons-id">id</span>; readonly attribute
 DOMString? <span data-x="dom-not-restored-reasons-name">name</span>; readonly attribute DOMString?
 <span data-x="dom-not-restored-reasons-url">url</span>; readonly attribute
-ObservableArray&lt;DOMString&gt;? <span data-x= "dom-not-restored-reasons-reasons">reasons</span>;
-readonly attribute ObservableArray&lt;<span>NotRestoredReasons</span>&gt;? <span
-data-x="dom-not-restored-reasons-children">children</span>; };</code></pre>
+ObservableArray&lt;DOMString&gt;? <dfn attribute for="NotRestoredReasons" data-x=
+"dom-not-restored-reasons-reasons">reasons</dfn>; readonly attribute
+ObservableArray&lt;<span>NotRestoredReasons</span>&gt;? <dfn attribute for="NotRestoredReasons"
+data-x="dom-not-restored-reasons-children">children</dfn>; };</code></pre>
 
-  <dl class="domintro">
+  <dl>
    <dt><code data-x=""><var>notRestoredReasons</var>.<span subdfn data-x= "dom-not-restored-reasons-prevented-back-forward-cache">preventedBackForwardCache </span></code></dt>
    <dd><p>Returns whether the document has blocked back/forward cache, from the list below. This is
    set to "<code data-x="dom-PreventedBackForwardcache-masked">masked</code>" if the document is in
@@ -89319,14 +89321,6 @@ data-x="dom-not-restored-reasons-children">children</span>; };</code></pre>
   <p>Every <code>NotRestoredReasons</code> object has a <dfn
   data-x="concept-not-restored-reasons-url">URL</dfn>, null or string, initially null.</p>
 
-  <p>Every <code>NotRestoredReasons</code> object has an associated <dfn
-  data-x="concept-not-restored-reasons-reasons">reasons</dfn> array, initially empty.
-  Each string in the array is from the <span data-x=
-  "concept-document-bfcache-blocking-reasons">bfcache blocking reasons</span> list.</p>
-
-  <p>Every <code>NotRestoredReasons</code> object has an associated <dfn
-  data-x="concept-not-restored-reasons-children">children</dfn> array, initially empty.</p>
-
   <p>The <dfn attribute for= "NotRestoredReasons"><code
   data-x="dom-not-restored-reasons-prevented-back-forward-cache"
   >preventedBackForwardCache</code></dfn> getter steps are to return <span>this</span>'s <span
@@ -89348,14 +89342,6 @@ data-x="dom-not-restored-reasons-children">children</span>; };</code></pre>
   data-x="dom-not-restored-reasons-url">URL</code></dfn> getter steps are to return
   <span>this</span>'s <span data-x="concept-not-restored-reasons-url">URL</span>.</p>
 
-  <p>The <dfn attribute for="NotRestoredReasons"><code
-  data-x="dom-not-restored-reasons-reasons">reasons</code></dfn> getter steps are to return
-  <span>this</span>'s <span data-x="concept-not-restored-reasons-reasons">reasons</span>.</p>
-
-  <p>The <dfn attribute for="NotRestoredReasons"><code
-  data-x="dom-not-restored-reasons-children">children</code></dfn> getter steps are to return
-  <span>this</span>'s <span data-x="concept-not-restored-reasons-children">children</span>.</p>
-
  <h3 split-filename="document-sequences">Infrastructure for sequences of documents</h3>
 
   <p>This standard contains several related concepts for grouping sequences of documents. As a
@@ -95486,8 +95472,8 @@ location.href = '#foo';</code></pre>
     <span data-x="concept-document-bfcache-blocking-reasons">bfcache blocking reasons</span>:</p>
      <ol>
       <li><p><span data-x="list append">Append</span> <var>reason</var> to
-      <var>notRestoredReasonsForDocument</var>'s <span
-      data-x="dom-not-restored-reasons-reasons">reasons</span>.</p></li>
+      <var>notRestoredReasonsForDocument</var>'s <code
+      data-x="dom-not-restored-reasons-reasons">reasons</code>'s <span>backing list</span>.</p></li>
      </ol>
    </li>
 
@@ -95514,21 +95500,21 @@ location.href = '#foo';</code></pre>
      navigable</span>'s <span data-x="nav-active-history-entry">active session history entry</span>'s
      <span data-x="she-document-state">document state</span>'s <span
      data-x="document-state-not-restored-reasons">notRestoredReasons</span> to
-     <var>notRestoredReasonsForDocument</var>'s <span
-     data-x="dom-not-restored-reasons-children">children</span>.</p></li>
+     <var>notRestoredReasonsForDocument</var>'s <code
+     data-x="dom-not-restored-reasons-children">children</code>'s <span>backing list</span>.</p></li>
     </ol>
-
    </li>
 
- </ol>
+   <li><p>Set <var>document</var>'s <span>node navigable</span>'s <span
+   data-x="nav-active-history-entry">active session history entry</span>'s <span
+   data-x="she-document-state">document state</span>'s <span
+   data-x="document-state-not-restored-reasons">notRestoredReasons</span> to
+   <var>notRestoredReasonsForDocument</var>.</p></li>
+  </ol>
 
- <p>To <dfn>build NotRestoredReasons object for page</dfn> given <code>document state</code>
- <var>documentState</var>:
+ <p>To <dfn>build NotRestoredReasons object for a top-level traversal and its descendants</dfn>
+ given <code>document state</code> <var>documentState</var>:
  <ol>
-  <li><p><span>Assert</span>: <var>documentState</var>'s <span
-  data-x="document-state-document">document</span>'s <span>node navigable</span> is a
-  <span>top-level traversable</span>.</p></li>
-
   <li><p><span>Build NotRestoredReasons object for document</span> given <var>documentState</var>'s
   <span data-x="document-state-document">document</span>.</p></li>
 
@@ -96680,9 +96666,9 @@ new PaymentRequest(&hellip;); // Allowed to use
    <li><p>Run any <span>unloading document cleanup steps</span> for <var>oldDocument</var> that are
    defined by this specification and <span>other applicable specifications</span>.</p></li>
 
-   <li><p>If <var>oldDocument</var>'s <span>node navigable</span> is a
-   <span>top-level traversable</span>, <span>build NotRestoredReasons object for page</span> given
-   <var>oldDocument</var>'s <span>node navigable</span>'s <span
+   <li><p>If <var>oldDocument</var>'s <span>node navigable</span> is a <span>top-level
+   traversable</span>, <span>build NotRestoredReasons object for a top-level traversal and its
+   descendants</span> given <var>oldDocument</var>'s <span>node navigable</span>'s <span
    data-x="nav-active-history-entry">active session history entry</span>'s <span
    data-x="she-document-state">document state</span>.</p></li>