WebAssembly.Module

Konstruktor

WebAssembly.Module()

Erstellt ein neues Module-Objekt.

Statische Methoden

WebAssembly.Module.customSections()

Gibt bei Angabe eines Module und einer Zeichenkette eine Kopie der Inhalte aller benutzerdefinierten Abschnitte im Modul mit dem angegebenen Zeichenkettennamen zurck.

WebAssembly.Module.exports()

Gibt bei Angabe eines Module ein Array zurck, das Beschreibungen aller deklarierten Exporte enthlt.

WebAssembly.Module.imports()

Gibt bei Angabe eines Module ein Array zurck, das Beschreibungen aller deklarierten Importe enthlt.

Beispiele

Ein kompiliertes Modul an einen Worker senden

Das folgende Beispiel kompiliert den geladenen Bytecode simple.wasm mit der Methode WebAssembly.compileStreaming() und sendet die resultierende Module-Instanz mithilfe von postMessage() an einen Worker.

Lesen Sie den index-compile.html-Quellcode oder sehen Sie ihn live an.

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

WebAssembly.compileStreaming(fetch("simple.wasm")).then((mod) =>
  worker.postMessage(mod),
);

Die Worker-Funktion wasm_worker.js definiert ein Importobjekt, das das Modul verwenden kann. Anschlieend richtet die Funktion einen Event-Handler ein, um das Modul vom Hauptthread zu empfangen. Wenn das Modul empfangen wird, erstellen wir mithilfe der Methode WebAssembly.instantiate() eine Instanz daraus und rufen eine darin exportierte Funktion auf.

const importObject = {
  my_namespace: {
    imported_func(arg) {
      console.log(arg);
    },
  },
};

onmessage = (e) => {
  console.log("module received from main thread");
  const mod = e.data;

  WebAssembly.instantiate(mod, importObject).then((instance) => {
    instance.exports.exported_func();
  });
};

Das Modul mit import source abrufen

In Umgebungen, die Quellphasenimporte untersttzen, knnen Sie mit der Anweisung import source oder dem Operator import.source() ein WebAssembly.Module-Objekt abrufen. Beide vermeiden die Notwendigkeit, fetch() oder WebAssembly.compileStreaming() aufzurufen, und verwenden stattdessen die standardmige Modullader-Infrastruktur.

import source modSource from "./simple.wasm";

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

Spezifikationen

Browser-Kompatibilitt

Siehe auch

• WebAssembly-berblick
• WebAssembly-Konzepte
• Verwenden der WebAssembly-JavaScript-API