L'objet JavaScript WebAssembly 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 que Math qui agit comme un espace de noms pour les constantes et fonctions mathématiques ou comme Intl qui centralise les constructeurs et les opérations relatives à l'internationalisation).

Description

L'objet WebAssembly est notamment utilisé pour :

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 une Instance ou en une Instance et un Module.
WebAssembly.instantiateStreaming()
Cette méthode peremet de compiler et d'instancier un module WebAssembly à partir d'un flux source (streamed source). Elle renvoie à la fois un objet Module et sa première Instance.
WebAssembly.compile()
Cette méthode permet de compiler un WebAssembly.Module à partir de bytecode  WebAssembly, l'instanciation doit alors être effectuée dans une autre étape.
WebAssembly.compileStreaming()
Cette méthode permet de compiler un module WebAssembly.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 du bytecode WebAssembly : elle renvoie true si les octets forment un code WebAssembly valide ou false sinon.

Constructeurs

WebAssembly.Module()
Ce constructeur permet de créer un objet WebAssembly Module.
WebAssembly.Instance()
Ce constructeur permet de créer un objet WebAssembly Instance.
WebAssembly.Memory()
Ce constructeur permet de créer un objet WebAssembly Memory.
WebAssembly.Table()
Ce constructeur permet de créer un objet WebAssembly Table.
WebAssembly.CompileError()
Ce constructeur permet de créer un objet WebAssembly CompileError.
WebAssembly.LinkError()
Ce constructeur permet de créer un objet WebAssembly LinkError.
WebAssembly.RuntimeError()
Ce constructeur permet de créer un objet WebAssembly RuntimeError.

Exemples

L'exemple suivant (cf. le fichier instantiate-streaming.html sur GitHub et le 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 objet ResultObject. La méthode instantiateStreaming() accepte une promesse pour l'argument Response, on peut lui passer directement un appel à WindowOrWorkerGlobalScope.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'instance ResultObject puis on appelle la fonction exportée.

Spécifications

Spécification État Commentaires
WebAssembly JavaScript Interface
La définition de 'WebAssembly' dans cette spécification.
Version de travail Brouillon de définition initiale.

Compatibilité des navigateurs

FonctionnalitéChromeEdgeFirefoxInternet ExplorerOperaSafari
Support simple5716522 Non4411
CompileError5716522 Non4411
Instance5716522 Non4411
LinkError5716522 Non4411
Memory5716522 Non4411
Module5716522 Non4411
RuntimeError5716522 Non4411
Table5716522 Non4411
compile5716522 Non4411
compileStreaming61 Non58 Non47 Non
instantiate5716522 Non4411
instantiateStreaming61 Non58 Non47 Non
validate5716522 Non4411
FonctionnalitéAndroid webviewChrome for AndroidEdge mobileFirefox for AndroidOpera AndroidiOS SafariSamsung Internet
Support simple5757 Oui1522 ?117.0
CompileError5757 Oui1522 ?117.0
Instance5757 Oui1522 ?117.0
LinkError5757 Oui1522 ?117.0
Memory5757 Oui1522 ?117.0
Module5757 Oui1522 ?117.0
RuntimeError5757 Oui1522 ?117.0
Table5757 Oui1522 ?117.0
compile5757 Oui1522 ?117.0
compileStreaming6161 Non58 ? Non Non
instantiate5757 Oui1522 ?117.0
instantiateStreaming6161 Non58 ? Non Non
validate5757 Oui1522 ?117.0

1. This feature is behind the Experimental JavaScript Features preference.

2. Disabled in the Firefox 52 Extended Support Release (ESR).

Voir aussi

Étiquettes et contributeurs liés au document

Contributeurs à cette page : SphinxKnight
Dernière mise à jour par : SphinxKnight,