Constructeur WebAssembly.Instance()

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.

Le constructeur WebAssembly.Instance() crée un nouvel objet Instance qui représente une instance sans état et exécutable d'un WebAssembly.Module.

Dans cet article

Syntaxe

Attention : Étant donné que l'instanciation de grands modules peut être coûteuse, il est préférable d'utiliser le constructeur Instance() uniquement lorsqu'une instanciation synchrone est nécessaire. Par défaut et dans tous les autres cas, on privilégiera l'utilisation de la méthode asynchrone WebAssembly.instantiateStreaming().

new WebAssembly.Instance(module, importObject);

Paramètres

module

L'objet WebAssembly.Module qu'on souhaite instancier.

importObject Facultatif

Un objet contenant les valeurs à importer dans l'instance nouvellement créée telles que des fonctions ou des objets WebAssembly.Memory. Il doit y avoir une propriété correspondante pour chaque import déclaré de module ou une exception WebAssembly.LinkError sera levée.

Exemples

Instancier un module WebAssembly de façon synchrone

Le constructeur WebAssembly.Instance() peut être appelé de façon synchrone afin d'instancier un objet WebAssembly.Module donné, par exemple :

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

fetch("simple.wasm")
  .then((response) => response.arrayBuffer())
  .then((bytes) => {
    let mod = new WebAssembly.Module(bytes);
    let instance = new WebAssembly.Instance(mod, importObject);
    instance.exports.exported_func();
  });

Toutefois, la méthode à privilégier pour obtenir une Instance est d'utiliser la fonction asynchrone WebAssembly.instantiateStreaming() comme ceci :

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

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

Aider à améliorer MDN

Cette page vous a-t-elle été utile ?

Oui Non

Apprendre à contribuer

Cette page a été modifiée le 7 sept. 2025 par les contributeur·ice·s du MDN.

Voir cette page sur GitHub • Signaler un problème avec ce contenu