WebAssembly.Module()

Baseline

Large disponibilit

Cette fonctionnalit est bien tablie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis octobre 2017.

* Certaines parties de cette fonctionnalit peuvent bnficier de prise en charge variables.

Voir la compatibilit complte
En savoir plus

Un objet WebAssembly.Module contient du code WebAssembly, sans tat et qui a dj t compil par le navigateur. Ce code peut tre partag avec des web workers et tre instanci plusieurs reprises.

Constructeur

WebAssembly.Module(): Cre un nouvel objet Module.

Proprits statiques

WebAssembly.Module.customSections(): Soit un objet Module et une chane de caractres, cette mthode renvoie le contenu de l'ensemble des sections spcifiques du module avec le nom correspondant la chane de caractres.
WebAssembly.Module.exports(): Soit un objet Module, cette mthode renvoie un tableau dont les lments sont les descriptions de tous les exports dclars.
WebAssembly.Module.imports(): Soit un objet Module, cette mthode renvoie un tableau dont les lments sont les descriptions de tous les imports dclars.

Dans l'exemple qui suit (voir le fichier source index-compile.html sur GitHub, et la dmonstration correspondante), on compile le byte code charg simple.wasm en utilisant la mthode WebAssembly.compileStreaming() puis en envoyant l'instance de Module rsultante un worker en utilisant postMessage().

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

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

Au sein du worker (voir le fichier wasm_worker.js), on dfinit un objet d'import pour le module utiliser puis on dfinit un gestionnaire d'vnement destin recevoir le module depuis le fil d'excution principal. Lorsque le module est reu, on en cre une instance avec la mthode WebAssembly.instantiate() puis on appelle une fonction exporte depuis l'instance.

let importObject = {
  imports: {
    imported_func: function (arg) {
      console.log(arg);
    },
  },
};

onmessage = function (e) {
  console.log("module reu depuis le thread principal");
  let mod = e.data;

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