add import bytes

Author: styfle

source

@@ -64211,6 +64211,21 @@ o............A....e
    response has a MIME type that is not a <span>JavaScript MIME type</span>.</p>
   </div>
 
+  <div class="example" id="bytes-module-script-example">
+   <p>The following sample shows how a <span>bytes module script</span> can be imported from inside
+   a <span>JavaScript module script</span>:</p>
+
+   <pre><code class="html" data-x="">&lt;script type="module">
+ import logoBytes from "https://resources.whatwg.org/logo.png" with { type: "bytes" };
+
+ console.log("Binary data length:", logoBytes.byteLength);
+&lt;/script></code></pre>
+
+   <p>The <span>Bytes module script</span> will return a <code>Uint8Array</code> object containing
+   the raw bytes of the fetched resource. Unlike <span data-x="JSON module script">JSON module scripts</span>
+   which require a specific MIME type, bytes modules can be used to import binary data from any resource.</p>
+  </div>
+
   <div w-nodev>
 
   <h5 id="script-processing-model">Processing model</h5>
@@ -112104,7 +112119,7 @@ document.querySelector("button").addEventListener("click", bound);
      script">JavaScript module scripts</span>;</p></li>
 
      <li><p>a <span>Synthetic Module Record</span>, for <span data-x="CSS module script">CSS module
-     scripts</span> and <span data-x="JSON module script">JSON module scripts</span>;</p></li>
+     scripts</span>, <span data-x="JSON module script">JSON module scripts</span>, and <span data-x="Bytes module script">Bytes module scripts</span>;</p></li>
 
      <li><p>a <span>WebAssembly Module Record</span>, for <span data-x="WebAssembly module
      script">WebAssembly module scripts</span>; or</p></li>
@@ -112206,18 +112221,32 @@ document.querySelector("button").addEventListener("click", bound);
     -->
    </li>
 
+   <li>
+    <p>A <span>module script</span> is a <dfn export>Bytes module script</dfn> if its <span
+    data-x="concept-script-record">record</span> is a <span>Synthetic Module Record</span>, and it
+    was created via the <span data-x="creating a Bytes module script">create a Bytes module
+    script</span> algorithm. Bytes module scripts represent binary data as Uint8Array backed by
+    an immutable ArrayBuffer.</p>
+
+    <!--
+     This definition is not super-rigorous, but it doesn't need to be for now. If we ever start
+     testing if something is a Bytes module script in algorithms, instead of just referring to the
+     concept, then we should consider adding a type item to the module script struct.
+    -->
+   </li>
+
    <li>
     <p>A <span>module script</span> is a <dfn export>WebAssembly module script</dfn> if
     its <span data-x="concept-script-record">record</span> is a <span>WebAssembly Module
     Record</span>.</p>
    </li>
   </ul>
 
-  <p class="note">As CSS style sheets and JSON documents do not import dependent modules, and do not
+  <p class="note">As CSS stylesheets, JSON documents, and binary data do not import dependent modules, and do not
   throw exceptions on evaluation, the <span data-x="concept-script-script-fetch-options">fetch
   options</span> and <span data-x="concept-script-base-url">base URL</span> of <span data-x="CSS
-  module script">CSS module scripts</span> and <span data-x="JSON module script">JSON module
-  scripts</span> and are always null.</p>
+  module script">CSS module scripts</span>, <span data-x="JSON module script">JSON module
+  scripts</span>, and <span data-x="Bytes module script">Bytes module scripts</span> are always null.</p>
 
   <p>The <dfn>active script</dfn> is determined by the following algorithm:</p>
 
@@ -113112,6 +113141,10 @@ document.querySelector("button").addEventListener("click", bound);
      <var>settingsObject</var>, <var>response</var>'s <span
      data-x="concept-response-url">URL</span>, and <var>options</var>.</p></li>
 
+     <li><p>If <var>moduleType</var> is "<code data-x="">bytes</code>", then set <var>moduleScript</var> to
+     the result of <span>creating a Bytes module script</span> given <var>bodyBytes</var> and
+     <var>settingsObject</var>.</p></li>
+
      <li>
       <p>Otherwise:</p>
       <ol>
@@ -113432,6 +113465,31 @@ document.querySelector("button").addEventListener("click", bound);
    <li><p>Return <var>script</var>.</p></li>
   </ol>
 
+  <p>To <dfn data-x="creating a Bytes module script">create a Bytes module script</dfn>, given a
+  byte sequence <var>bytes</var> and an <span>environment settings object</span> <var>settings</var>:</p>
+
+  <ol>
+   <li><p>Let <var>script</var> be a new <span>module script</span> that this algorithm will
+   subsequently initialize.</p></li>
+
+   <li><p>Set <var>script</var>'s <span data-x="concept-script-settings-object">settings
+   object</span> to <var>settings</var>.</p></li>
+
+   <li><p>Set <var>script</var>'s <span data-x="concept-script-base-url">base URL</span> and
+   <span data-x="concept-script-script-fetch-options">fetch options</span> to null.</p></li>
+
+   <li><p>Set <var>script</var>'s <span data-x="concept-script-parse-error">parse error</span> and
+   <span data-x="concept-script-error-to-rethrow">error to rethrow</span> to null.</p></li>
+
+   <li><p>Let <var>result</var> be a new <code>Uint8Array</code> object, in <var>settings</var>'s
+   <span data-x="environment settings object's realm">realm</span>, whose backing bytes are <var>bytes</var>.</p></li>
+
+   <li><p>Set <var>script</var>'s <span data-x="concept-script-record">record</span> to the result
+   of <span>CreateDefaultExportSyntheticModule</span>(<var>result</var>).</p></li>
+
+   <li><p>Return <var>script</var>.</p></li>
+  </ol>
+
   <p>The <dfn>module type from module request</dfn> steps, given a <span>ModuleRequest
   Record</span> <var>moduleRequest</var>, are as follows:</p>
 
@@ -113467,7 +113525,7 @@ document.querySelector("button").addEventListener("click", bound);
 
   <ol>
    <li><p>If <var>moduleType</var> is not "<code data-x="">javascript-or-wasm</code>", "<code
-   data-x="">css</code>", or "<code data-x="">json</code>", then return false.</p></li>
+   data-x="">css</code>", "<code data-x="">json</code>", or "<code data-x="">bytes</code>", then return false.</p></li>
 
    <li><p>If <var>moduleType</var> is "<code data-x="">css</code>" and the
    <code>CSSStyleSheet</code> interface is not <span data-x="idl-exposed">exposed</span> in
@@ -113488,6 +113546,9 @@ document.querySelector("button").addEventListener("click", bound);
    <li>If <var>moduleType</var> is "<code data-x="">css</code>", then return "<code
    data-x="">style</code>".</li>
 
+   <li>If <var>moduleType</var> is "<code data-x="">bytes</code>", then return "<code
+   data-x="">empty</code>".</li>
+
    <li>Return <var>defaultDestination</var>.</li>
   </ol>