WebAssembly.instantiateStreaming()

source

Un objet Response ou une promesse qui sera tenue avec une valeur Response qui représente la source du module .wasm dont on souhaite récupérer le flux, la compiler puis l'instancier.

importObject Facultatif

Un objet qui contient les valeurs qui doivent être importées dans le nouvel objet Instance résultant. Cela peut être des fonctions ou des objets WebAssembly.Memory. Il est nécessaire qu'il y ait une propriété correspondante pour chaque import déclaré dans le module compilé, sinon, une exception WebAssembly.LinkError sera levée.

Un objet Promise dont la valeur de résolution est un objet ResultObject contenant deux champs :

module

Un objet WebAssembly.Module qui représente le module WebAssembly compilé. Ce module pourra être instancié à nouveau, partagé avec postMessage().

instance

Un objet WebAssembly.Instance qui contient l'ensemble des fonctions WebAssembly exportées.

• Si l'un des paramètres n'est pas du bon type ou ne possède pas la bonne structure, une exception TypeError est déclenchée.
• Si l'opération échoue, la promesse lève une exception WebAssembly.CompileError, WebAssembly.LinkError, ou WebAssembly.RuntimeErrorselon la cause de l'échec.

Dans l'exemple suivant (également disponible sur GitHub : instantiate-streaming.html et avec le résultat live), on récupère le flux d'un module .wasm depuis une source, on le compile et on l'instancie. La promesse est alors résolue avec un objet ResultObject. La méthode instantiateStreaming() acceptant une promesse fournissant un objet Response, on peut directement l'appel de fetch() en argument qui transfèrera la réponse lorsque la promesse résultante sera tenue.

const importObject = { imports: { imported_func: (arg) => console.log(arg) } };

WebAssembly.instantiateStreaming(fetch("simple.wasm"), importObject).then(
  (obj) => obj.instance.exports.exported_func(),
);

Ensuite, on accède au champ instance de l'objet ResultObject afin de pouvoir invoquer une des fonctions exportées.

• La page d'aperçu de WebAssembly
• Les concepts relatifs à WebAssembly
• Utiliser l'API JavaScript de WebAssembly