WebAssembly.compile()

Syntax

WebAssembly.compile(bufferSource)
WebAssembly.compile(bufferSource, compileOptions)

Parameter

bufferSource

Ein typisiertes Array oder ArrayBuffer, das den Binrcode des zu kompilierenden Wasm-Moduls enthlt.

compileOptions Optional

Ein Objekt, das Kompilierungsoptionen enthlt. Eigenschaften knnen enthalten:

builtins Optional

Ein Array von einem oder mehreren Zeichenfolgen, das die Verwendung von JavaScript builtins im kompilierten Wasm-Modul ermglicht. Die Zeichenfolgen definieren die Builtins, die Sie aktivieren mchten. Derzeit ist der einzige verfgbare Wert "js-string", der JavaScript-String-Builtins aktiviert.

importedStringConstants Optional

Eine Zeichenfolge, die einen Namensraum fr importierte globale String-Konstanten angibt. Diese Eigenschaft muss angegeben werden, wenn Sie importierte globale String-Konstanten im Wasm-Modul verwenden mchten.

Rckgabewert

Ein Promise, das sich zu einem WebAssembly.Module-Objekt auflst und das kompilierte Modul darstellt.

Ausnahmen

• Wenn bufferSource kein typisiertes Array oder ArrayBuffer ist, wird das Promise mit einem TypeError abgelehnt.
• Wenn die Kompilierung fehlschlgt, wird das Promise mit einem WebAssembly.CompileError abgelehnt.

Beispiele

Verwendung von compile

Im folgenden Beispiel wird der geladene einfache Wasm-Bytecode mit der Funktion compile() kompiliert und dann mit postMessage() an einen Worker gesendet.

const worker = new Worker("wasm_worker.js");

fetch("simple.wasm")
  .then((response) => response.arrayBuffer())
  .then((bytes) => WebAssembly.compile(bytes))
  .then((mod) => worker.postMessage(mod));

Aktivieren von JavaScript-Builtins und globalen String-Importen

Dieses Beispiel aktiviert JavaScript-String-Builtins und importierte globale String-Konstanten, wenn das Wasm-Modul mit compile() kompiliert wird, bevor es mit instantiate() instanziiert und anschlieend die exportierte main()-Funktion (die "hello world!" auf die Konsole schreibt) ausgefhrt wird. Siehe es live in Aktion.

const importObject = {
  // Regular import
  m: {
    log: console.log,
  },
};

const compileOptions = {
  builtins: ["js-string"], // Enable JavaScript string builtins
  importedStringConstants: "string_constants", // Enable imported global string constants
};

fetch("log-concat.wasm")
  .then((response) => response.arrayBuffer())
  .then((bytes) => WebAssembly.compile(bytes, compileOptions))
  .then((module) => WebAssembly.instantiate(module, importObject))
  .then((instance) => instance.exports.main());

Spezifikationen

Browser-Kompatibilitt

Siehe auch

• WebAssembly bersicht
• WebAssembly-Konzepte
• Verwendung der WebAssembly-JavaScript-API