Reorder reading algorithm and data arguments (#426)

twiss · github-actions[bot] · twiss · commit 0803cda35477 · 2026-02-26T13:59:47.000Z
SHA: 5b57233 Reason: push, by twiss Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
diff --git a/index.html b/index.html
@@ -123,7 +123,7 @@
       
 
 <meta name="color-scheme" content="light">
-<meta name="revision" content="9d98db771af207ff2270175f71baad350742e4aa">
+<meta name="revision" content="5b57233c0a2c01a2638d7aaa427fd80a89b968f2">
 <meta name="description" content="This specification describes a JavaScript API for performing basic
         cryptographic operations in web applications, such as hashing,
         signature generation and verification, and encryption and decryption.
@@ -242,17 +242,17 @@
       "id": "x690"
     }
   },
-  "gitRevision": "9d98db771af207ff2270175f71baad350742e4aa",
-  "publishISODate": "2026-01-29T00:00:00.000Z",
-  "generatedSubtitle": "W3C Editor's Draft 29 January 2026"
+  "gitRevision": "5b57233c0a2c01a2638d7aaa427fd80a89b968f2",
+  "publishISODate": "2026-02-26T00:00:00.000Z",
+  "generatedSubtitle": "W3C Editor's Draft 26 February 2026"
 }</script>
 <link rel="stylesheet" href="https://www.w3.org/StyleSheets/TR/2021/W3C-ED"></head>
 
   <body class="h-entry" data-cite="WEBIDL html dom webidl infra encoding"><div class="head">
     <p class="logos"><a class="logo" href="https://www.w3.org/"><img crossorigin="" alt="W3C" height="48" src="https://www.w3.org/StyleSheets/TR/2021/logos/W3C" width="72">
   </a></p>
     <h1 id="title" class="title">Web Cryptography API Level 2</h1> 
-    <p id="w3c-state"><a href="https://www.w3.org/standards/types#ED">W3C Editor's Draft</a> <time class="dt-published" datetime="2026-01-29">29 January 2026</time></p>
+    <p id="w3c-state"><a href="https://www.w3.org/standards/types#ED">W3C Editor's Draft</a> <time class="dt-published" datetime="2026-02-26">26 February 2026</time></p>
     <details open="">
       <summary>More details about this document</summary>
       <dl>
@@ -1669,13 +1669,6 @@ <h1 id="title" class="title">Web Cryptography API Level 2</h1>
                   respectively.
                 </p>
               </li>
-              <li>
-                <p>
-                  Let <var>data</var> be the result of
-                  <a data-link-type="dfn" data-lt="get a copy of the buffer source" href="https://webidl.spec.whatwg.org/#dfn-get-buffer-source-copy">getting a copy of the bytes held by</a> the <code>data</code> parameter passed to the
-                  <a data-link-type="idl" data-lt="encrypt()" href="#dfn-SubtleCrypto-method-encrypt" class="internalDFN" id="ref-for-dfn-SubtleCrypto-method-encrypt-3"><code>encrypt</code></a><code>()</code> method.
-                </p>
-              </li>
               <li>
                 <p>
                   Let <var>normalizedAlgorithm</var> be the result of
@@ -1690,6 +1683,13 @@ <h1 id="title" class="title">Web Cryptography API Level 2</h1>
                   <var>normalizedAlgorithm</var>.
                 </p>
               </li>
+              <li>
+                <p>
+                  Let <var>data</var> be the result of
+                  <a data-link-type="dfn" data-lt="get a copy of the buffer source" href="https://webidl.spec.whatwg.org/#dfn-get-buffer-source-copy">getting a copy of the bytes held by</a> the <code>data</code> parameter passed to the
+                  <a data-link-type="idl" data-lt="encrypt()" href="#dfn-SubtleCrypto-method-encrypt" class="internalDFN" id="ref-for-dfn-SubtleCrypto-method-encrypt-3"><code>encrypt</code></a><code>()</code> method.
+                </p>
+              </li>
               <li>
                 <p>
                   Let <var>realm</var> be the <a data-link-type="dfn" href="https://html.spec.whatwg.org/multipage/webappapis.html#concept-relevant-realm">relevant realm</a> of <a data-link-type="dfn" href="https://webidl.spec.whatwg.org/#this">this</a>.
@@ -1775,13 +1775,6 @@ <h1 id="title" class="title">Web Cryptography API Level 2</h1>
                   respectively.
                 </p>
               </li>
-              <li>
-                <p>
-                  Let <var>data</var> be the result of
-                  <a data-link-type="dfn" data-lt="get a copy of the buffer source" href="https://webidl.spec.whatwg.org/#dfn-get-buffer-source-copy">getting a copy of the bytes held by</a> the <code>data</code> parameter passed to the
-                  <a data-link-type="idl" data-lt="decrypt()" href="#dfn-SubtleCrypto-method-decrypt" class="internalDFN" id="ref-for-dfn-SubtleCrypto-method-decrypt-3"><code>decrypt</code></a><code>()</code> method.
-                </p>
-              </li>
               <li>
                 <p>
                   Let <var>normalizedAlgorithm</var> be the result of
@@ -1796,6 +1789,13 @@ <h1 id="title" class="title">Web Cryptography API Level 2</h1>
                   <var>normalizedAlgorithm</var>.
                 </p>
               </li>
+              <li>
+                <p>
+                  Let <var>data</var> be the result of
+                  <a data-link-type="dfn" data-lt="get a copy of the buffer source" href="https://webidl.spec.whatwg.org/#dfn-get-buffer-source-copy">getting a copy of the bytes held by</a> the <code>data</code> parameter passed to the
+                  <a data-link-type="idl" data-lt="decrypt()" href="#dfn-SubtleCrypto-method-decrypt" class="internalDFN" id="ref-for-dfn-SubtleCrypto-method-decrypt-3"><code>decrypt</code></a><code>()</code> method.
+                </p>
+              </li>
               <li>
                 <p>
                   Let <var>realm</var> be the <a data-link-type="dfn" href="https://html.spec.whatwg.org/multipage/webappapis.html#concept-relevant-realm">relevant realm</a> of <a data-link-type="dfn" href="https://webidl.spec.whatwg.org/#this">this</a>.
@@ -1881,13 +1881,6 @@ <h1 id="title" class="title">Web Cryptography API Level 2</h1>
                   respectively.
                 </p>
               </li>
-              <li>
-                <p>
-                  Let <var>data</var> be the result of
-                  <a data-link-type="dfn" data-lt="get a copy of the buffer source" href="https://webidl.spec.whatwg.org/#dfn-get-buffer-source-copy">getting a copy of the bytes held by</a> the <code>data</code> parameter passed to the
-                  <a data-link-type="idl" data-lt="sign()" href="#dfn-SubtleCrypto-method-sign" class="internalDFN" id="ref-for-dfn-SubtleCrypto-method-sign-3"><code>sign</code></a><code>()</code> method.
-                </p>
-              </li>
               <li>
                 <p>
                   Let <var>normalizedAlgorithm</var> be the result of
@@ -1902,6 +1895,13 @@ <h1 id="title" class="title">Web Cryptography API Level 2</h1>
                   <var>normalizedAlgorithm</var>.
                 </p>
               </li>
+              <li>
+                <p>
+                  Let <var>data</var> be the result of
+                  <a data-link-type="dfn" data-lt="get a copy of the buffer source" href="https://webidl.spec.whatwg.org/#dfn-get-buffer-source-copy">getting a copy of the bytes held by</a> the <code>data</code> parameter passed to the
+                  <a data-link-type="idl" data-lt="sign()" href="#dfn-SubtleCrypto-method-sign" class="internalDFN" id="ref-for-dfn-SubtleCrypto-method-sign-3"><code>sign</code></a><code>()</code> method.
+                </p>
+              </li>
               <li>
                 <p>
                   Let <var>realm</var> be the <a data-link-type="dfn" href="https://html.spec.whatwg.org/multipage/webappapis.html#concept-relevant-realm">relevant realm</a> of <a data-link-type="dfn" href="https://webidl.spec.whatwg.org/#this">this</a>.
@@ -1987,33 +1987,32 @@ <h1 id="title" class="title">Web Cryptography API Level 2</h1>
               </li>
               <li>
                 <p>
-                  Let <var>signature</var> be the result of
-                  <a data-link-type="dfn" data-lt="get a copy of the buffer source" href="https://webidl.spec.whatwg.org/#dfn-get-buffer-source-copy">getting a copy of the bytes held by</a> the <code>signature</code> parameter passed to the
-                  <a data-link-type="idl" data-lt="verify()" href="#dfn-SubtleCrypto-method-verify" class="internalDFN" id="ref-for-dfn-SubtleCrypto-method-verify-3"><code>verify</code></a><code>()</code> method.
+                  Let <var>normalizedAlgorithm</var> be the result of
+                  <a href="#dfn-normalize-an-algorithm" id="ref-for-dfn-normalize-an-algorithm-4">normalizing an algorithm</a>, with
+                  <code>alg</code> set to <var>algorithm</var> and <code>op</code> set to
+                  "<code>verify</code>".
                 </p>
               </li>
               <li>
                 <p>
-                  Let <var>data</var> be the result of
-                  <a data-link-type="dfn" data-lt="get a copy of the buffer source" href="https://webidl.spec.whatwg.org/#dfn-get-buffer-source-copy">getting a copy of the bytes held by</a> the <code>data</code> parameter passed to the
-                  <a data-link-type="idl" data-lt="verify()" href="#dfn-SubtleCrypto-method-verify" class="internalDFN" id="ref-for-dfn-SubtleCrypto-method-verify-4"><code>verify</code></a><code>()</code> method.
+                  If an error occurred, return a Promise rejected with
+                  <var>normalizedAlgorithm</var>.
                 </p>
               </li>
               <li>
                 <p>
-                  Let <var>normalizedAlgorithm</var> be the result of
-                  <a href="#dfn-normalize-an-algorithm" id="ref-for-dfn-normalize-an-algorithm-4">normalizing an algorithm</a>, with
-                  <code>alg</code> set to <var>algorithm</var> and <code>op</code> set to
-                  "<code>verify</code>".
+                  Let <var>signature</var> be the result of
+                  <a data-link-type="dfn" data-lt="get a copy of the buffer source" href="https://webidl.spec.whatwg.org/#dfn-get-buffer-source-copy">getting a copy of the bytes held by</a> the <code>signature</code> parameter passed to the
+                  <a data-link-type="idl" data-lt="verify()" href="#dfn-SubtleCrypto-method-verify" class="internalDFN" id="ref-for-dfn-SubtleCrypto-method-verify-3"><code>verify</code></a><code>()</code> method.
                 </p>
               </li>
               <li>
                 <p>
-                  If an error occurred, return a Promise rejected with
-                  <var>normalizedAlgorithm</var>.
+                  Let <var>data</var> be the result of
+                  <a data-link-type="dfn" data-lt="get a copy of the buffer source" href="https://webidl.spec.whatwg.org/#dfn-get-buffer-source-copy">getting a copy of the bytes held by</a> the <code>data</code> parameter passed to the
+                  <a data-link-type="idl" data-lt="verify()" href="#dfn-SubtleCrypto-method-verify" class="internalDFN" id="ref-for-dfn-SubtleCrypto-method-verify-4"><code>verify</code></a><code>()</code> method.
                 </p>
               </li>
-
               <li>
                 <p>
                   Let <var>realm</var> be the <a data-link-type="dfn" href="https://html.spec.whatwg.org/multipage/webappapis.html#concept-relevant-realm">relevant realm</a> of <a data-link-type="dfn" href="https://webidl.spec.whatwg.org/#this">this</a>.
@@ -2092,13 +2091,6 @@ <h1 id="title" class="title">Web Cryptography API Level 2</h1>
                   <a data-link-type="idl" data-lt="digest()" href="#dfn-SubtleCrypto-method-digest" class="internalDFN" id="ref-for-dfn-SubtleCrypto-method-digest-2"><code>digest</code></a><code>()</code> method.
                 </p>
               </li>
-              <li>
-                <p>
-                  Let <var>data</var> be the result of
-                  <a data-link-type="dfn" data-lt="get a copy of the buffer source" href="https://webidl.spec.whatwg.org/#dfn-get-buffer-source-copy">getting a copy of the bytes held by</a> the <code>data</code> parameter passed to the
-                  <a data-link-type="idl" data-lt="digest()" href="#dfn-SubtleCrypto-method-digest" class="internalDFN" id="ref-for-dfn-SubtleCrypto-method-digest-3"><code>digest</code></a><code>()</code> method.
-                </p>
-              </li>
               <li>
                 <p>
                   Let <var>normalizedAlgorithm</var> be the result of
@@ -2113,6 +2105,13 @@ <h1 id="title" class="title">Web Cryptography API Level 2</h1>
                   <var>normalizedAlgorithm</var>.
                 </p>
               </li>
+              <li>
+                <p>
+                  Let <var>data</var> be the result of
+                  <a data-link-type="dfn" data-lt="get a copy of the buffer source" href="https://webidl.spec.whatwg.org/#dfn-get-buffer-source-copy">getting a copy of the bytes held by</a> the <code>data</code> parameter passed to the
+                  <a data-link-type="idl" data-lt="digest()" href="#dfn-SubtleCrypto-method-digest" class="internalDFN" id="ref-for-dfn-SubtleCrypto-method-digest-3"><code>digest</code></a><code>()</code> method.
+                </p>
+              </li>
               <li>
                 <p>
                   Let <var>realm</var> be the <a data-link-type="dfn" href="https://html.spec.whatwg.org/multipage/webappapis.html#concept-relevant-realm">relevant realm</a> of <a data-link-type="dfn" href="https://webidl.spec.whatwg.org/#this">this</a>.
@@ -2545,6 +2544,20 @@ <h1 id="title" class="title">Web Cryptography API Level 2</h1>
                   <code>extractable</code> and <code>keyUsages</code> parameters passed to the <a data-link-type="idl" data-lt="importKey()" href="#dfn-SubtleCrypto-method-importKey" class="internalDFN" id="ref-for-dfn-SubtleCrypto-method-importKey-2"><code>importKey</code></a><code>()</code> method, respectively.
                 </p>
               </li>
+              <li>
+                <p>
+                  Let <var>normalizedAlgorithm</var> be the result of
+                  <a href="#dfn-normalize-an-algorithm" id="ref-for-dfn-normalize-an-algorithm-11">normalizing an algorithm</a>, with
+                  <code>alg</code> set to <var>algorithm</var> and <code>op</code> set to
+                  "<code>importKey</code>".
+                </p>
+              </li>
+              <li>
+                <p>
+                  If an error occurred, return a Promise rejected with
+                  <var>normalizedAlgorithm</var>.
+                </p>
+              </li>
               <li>
                 <dl class="switch">
                   <dt>
@@ -2591,20 +2604,6 @@ <h1 id="title" class="title">Web Cryptography API Level 2</h1>
                   </dd>
                 </dl>
               </li>
-              <li>
-                <p>
-                  Let <var>normalizedAlgorithm</var> be the result of
-                  <a href="#dfn-normalize-an-algorithm" id="ref-for-dfn-normalize-an-algorithm-11">normalizing an algorithm</a>, with
-                  <code>alg</code> set to <var>algorithm</var> and <code>op</code> set to
-                  "<code>importKey</code>".
-                </p>
-              </li>
-              <li>
-                <p>
-                  If an error occurred, return a Promise rejected with
-                  <var>normalizedAlgorithm</var>.
-                </p>
-              </li>
               <li>
                 <p>
                   Let <var>realm</var> be the <a data-link-type="dfn" href="https://html.spec.whatwg.org/multipage/webappapis.html#concept-relevant-realm">relevant realm</a> of <a data-link-type="dfn" href="https://webidl.spec.whatwg.org/#this">this</a>.
@@ -2996,7 +2995,7 @@ <h1 id="title" class="title">Web Cryptography API Level 2</h1>
               <em class="rfc2119">MUST</em> perform the following steps:
             </p>
             <ol>
-            <li>
+              <li>
                 <p>
                   Let <var>format</var>, <var>unwrappingKey</var>,
                   <var>algorithm</var>, <var>unwrappedKeyAlgorithm</var>,
@@ -3009,14 +3008,6 @@ <h1 id="title" class="title">Web Cryptography API Level 2</h1>
                   respectively.
                 </p>
               </li>
-              <li>
-                <p>
-                  Let <var>wrappedKey</var> be the result of
-                  <a data-link-type="dfn" data-lt="get a copy of the buffer source" href="https://webidl.spec.whatwg.org/#dfn-get-buffer-source-copy">getting a copy of the bytes held by</a> the
-                  <code>wrappedKey</code> parameter passed to the
-                  <a data-link-type="idl" data-lt="unwrapKey()" href="#dfn-SubtleCrypto-method-unwrapKey" class="internalDFN" id="ref-for-dfn-SubtleCrypto-method-unwrapKey-3"><code>unwrapKey</code></a><code>()</code> method.
-                </p>
-              </li>
               <li>
                 <p>
                   Let <var>normalizedAlgorithm</var> be the result of
@@ -3052,6 +3043,14 @@ <h1 id="title" class="title">Web Cryptography API Level 2</h1>
                   <var>normalizedKeyAlgorithm</var>.
                 </p>
               </li>
+              <li>
+                <p>
+                  Let <var>wrappedKey</var> be the result of
+                  <a data-link-type="dfn" data-lt="get a copy of the buffer source" href="https://webidl.spec.whatwg.org/#dfn-get-buffer-source-copy">getting a copy of the bytes held by</a> the
+                  <code>wrappedKey</code> parameter passed to the
+                  <a data-link-type="idl" data-lt="unwrapKey()" href="#dfn-SubtleCrypto-method-unwrapKey" class="internalDFN" id="ref-for-dfn-SubtleCrypto-method-unwrapKey-3"><code>unwrapKey</code></a><code>()</code> method.
+                </p>
+              </li>
               <li>
                 <p>
                   Let <var>realm</var> be the <a data-link-type="dfn" href="https://html.spec.whatwg.org/multipage/webappapis.html#concept-relevant-realm">relevant realm</a> of <a data-link-type="dfn" href="https://webidl.spec.whatwg.org/#this">this</a>.
