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.
Un objet WebAssembly.Module
contient du code WebAssembly, sans état et qui a déjà été compilé par le navigateur. Ce code peut être partagé avec des web workers et être instancié à plusieurs reprises.
Constructeur
WebAssembly.Module()
-
Crée un nouvel objet
Module
.
Propriétés statiques
WebAssembly.Module.customSections()
-
Soit un objet
Module
et une chaîne de caractères, cette méthode renvoie le contenu de l'ensemble des sections spécifiques du module avec le nom correspondant à la chaîne de caractères. WebAssembly.Module.exports()
-
Soit un objet
Module
, cette méthode renvoie un tableau dont les éléments sont les descriptions de tous les exports déclarés. WebAssembly.Module.imports()
-
Soit un objet
Module
, cette méthode renvoie un tableau dont les éléments sont les descriptions de tous les imports déclarés.
Exemples
Envoyer un module compilé à un worker
Dans l'exemple qui suit (voir le fichier source index-compile.html
sur GitHub, et la démonstration correspondante), on compile le byte code chargé simple.wasm
en utilisant la méthode WebAssembly.compileStreaming()
puis en envoyant l'instance de Module
résultante à 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 définit un objet d'import pour le module à utiliser puis on définit un gestionnaire d'évènement destiné à recevoir le module depuis le fil d'exécution principal. Lorsque le module est reçu, on en crée une instance avec la méthode WebAssembly.instantiate()
puis on appelle une fonction exportée depuis l'instance.
let importObject = {
imports: {
imported_func: function (arg) {
console.log(arg);
},
},
};
onmessage = function (e) {
console.log("module reçu depuis le thread principal");
let mod = e.data;
WebAssembly.instantiate(mod, importObject).then(function (instance) {
instance.exports.exported_func();
});
};
Spécifications
Specification |
---|
WebAssembly JavaScript Interface # modules |
Compatibilité des navigateurs
BCD tables only load in the browser