WebAssembly.Module

Baseline Widely available *

This feature is well established and works across many devices and browser versions. It’s been available across browsers since October 2017.

* Some parts of this feature may have varying levels of support.

Ein WebAssembly.Module-Objekt enthält zustandslosen WebAssembly-Code, der bereits vom Browser kompiliert wurde — dieser kann effizient mit Arbeitern geteilt werden und mehrfach instanziiert werden.

Hinweis: Das WebAssembly.Module-Objekt ist nicht mit dem Module-Objekt von Emscripten verwandt.

Konstruktor

WebAssembly.Module()

Erstellt ein neues Module-Objekt.

Statische Methoden

WebAssembly.Module.customSections()

Gibt bei einem Module und einem String eine Kopie des Inhalts aller benutzerdefinierten Sektionen im Modul mit dem angegebenen String-Namen zurück.

WebAssembly.Module.exports()

Gibt bei einem Module ein Array zurück, das Beschreibungen aller deklarierten Exporte enthält.

WebAssembly.Module.imports()

Gibt bei einem Module ein Array zurück, das Beschreibungen aller deklarierten Importe enthält.

Beispiele

Versand eines kompilierten Moduls an einen Worker

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

Siehe den index-compile.html Quellcode oder sehen Sie sich das live an.

js
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 für das Modul zur Verwendung. Die Funktion richtet dann einen Ereignishandler ein, um das Modul vom Hauptthread zu empfangen. Wenn das Modul empfangen wird, erstellen wir eine Instanz daraus mit der Methode WebAssembly.instantiate() und rufen eine exportierte Funktion von innen auf.

js
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();
  });
};

Spezifikationen

Specification
WebAssembly JavaScript Interface
# modules

Browser-Kompatibilität

Siehe auch