WebAssembly

Baseline Widely available *

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 bénéficier de prise en charge variables.

L'objet JavaScriptWebAssembly est un objet global qui agit comme un espace de noms (namespace) pour les différentes fonctionnalités JavaScript relatives àWebAssembly.

À la différence des autres objets globaux,WebAssembly n'est pas un constructeur (au même titre queMath qui agit comme un espace de noms pour les constantes et fonctions mathématiques ou commeIntl qui centralise les constructeurs et les opérations relatives à l'internationalisation).

Description

L'objetWebAssembly est notamment utilisé pour :

Charger du code WebAssembly grâce à la fonctionWebAssembly.instantiate()
Créer des zones mémoires et des instances de tableaux grâce aux constructeursWebAssembly.Memory()/WebAssembly.Table().
Fournir des outils de gestion d'erreur WebAssembly grâce aux constructeursWebAssembly.CompileError()/WebAssembly.LinkError()/WebAssembly.RuntimeError().

Méthodes

WebAssembly.instantiate(): La méthode qu'on utilisera la plupart du temps pour compiler et instancier du code WebAssembly, elle renvoie une promesse qui est résolue en uneInstance ou en uneInstance et unModule.
WebAssembly.instantiateStreaming(): Cette méthode permet de compiler et d'instancier un module WebAssembly à partir d'un flux source (streamed source). Elle renvoie à la fois un objetModule et sa premièreInstance.
WebAssembly.compile(): Cette méthode permet de compiler unWebAssembly.Module à partir debytecode WebAssembly, l'instanciation doit alors être effectuée dans une autre étape.
WebAssembly.compileStreaming(): Cette méthode permet de compiler un moduleWebAssembly.Module à partir d'un flux source (streamed source). L'instanciation devra alors être réalisée avec une autre étape.
WebAssembly.validate(): Cette méthode permet de valider un tableau typé censé contenir dubytecode WebAssembly : elle renvoietrue si les octets forment un code WebAssembly valide oufalse sinon.

Constructeurs

WebAssembly.Global(): Ce constructeur permet de créer un nouvel objet WebAssemblyGlobal.
WebAssembly.Module(): Ce constructeur permet de créer un objet WebAssemblyModule.
WebAssembly.Instance(): Ce constructeur permet de créer un objet WebAssemblyInstance.
WebAssembly.Memory(): Ce constructeur permet de créer un objet WebAssemblyMemory.
WebAssembly.Table(): Ce constructeur permet de créer un objet WebAssemblyTable.
WebAssembly.CompileError(): Ce constructeur permet de créer un objet WebAssemblyCompileError.
WebAssembly.LinkError(): Ce constructeur permet de créer un objet WebAssemblyLinkError.
WebAssembly.RuntimeError(): Ce constructeur permet de créer un objet WebAssemblyRuntimeError.

Exemples

L'exemple suivant (cf. le fichierinstantiate-streaming.html sur GitHub etle résultat obtenu) permet de récupérer le module WebAssembly via un flux depuis une source, de le compiler, puis de l'instancier. La promesse est résolue avec un objetResultObject. La méthodeinstantiateStreaming() accepte une promesse pour l'argumentResponse, on peut lui passer directement un appel àfetch() qui passera ensuite la réponse à la fonction lors de la complétion de la promesse.

var importObject = { imports: { imported_func: (arg) => console.log(arg) } };WebAssembly.instantiateStreaming(fetch("simple.wasm"), importObject).then(  (obj) => obj.instance.exports.exported_func(),);

On accède alors à la propriété de l'instanceResultObject puis on appelle la fonction exportée.