WebAssembly.validate()

Syntax

WebAssembly.validate(bufferSource)
WebAssembly.validate(bufferSource, compileOptions)

Parameter

bufferSource

Ein typisiertes Array oder ArrayBuffer das den zu validierenden WebAssembly-Binrcode enthlt.

compileOptions Optional

Ein Objekt, das Kompilierungsoptionen enthlt. Dieser Parameter ist in der validate()-Methode enthalten, damit er verwendet werden kann, um Module zu validieren, wenn Kompilierungsoptionen vorhanden sind (zum Beispiel, um Funktionsdetektion zu implementieren). Eigenschaften knnen beinhalten:

builtins Optional

Ein Array von Strings, das die Nutzung von JavaScript Builtins im kompilierten Wasm-Modul ermglicht. Die Strings definieren die Builtins, die Sie aktivieren mchten. Derzeit ist der einzige verfgbare Wert "js-string", der JavaScript-String-Builtins aktiviert.

importedStringConstants Optional

Ein String, der einen Namespace fr importierte globale String-Konstanten angibt. Diese Eigenschaft muss angegeben werden, wenn Sie importierte globale String-Konstanten im Wasm-Modul verwenden mchten.

Rckgabewert

Ein Boolean, der angibt, ob bufferSource gltiger Wasm-Code ist (true) oder nicht (false).

Ausnahmen

Wenn bufferSource kein typisiertes Array oder ArrayBuffer ist, wird ein TypeError ausgelst.

Beispiele

Verwendung von validate

Das folgende Beispiel (siehe den validate.html Quellcode und sehen Sie es auch live) ruft ein Wasm-Modul ab und konvertiert es in ein typisiertes Array. Die validate()-Methode wird dann verwendet, um zu prfen, ob das Modul gltig ist.

fetch("simple.wasm")
  .then((response) => response.arrayBuffer())
  .then((bytes) => {
    const valid = WebAssembly.validate(bytes);
    console.log(
      `The given bytes are ${valid ? "" : "not "}a valid Wasm module`,
    );
  });

Validierung eines Moduls mit aktivierten JavaScript Builtins und globalen String-Imports

Dieses Beispiel validiert ein Wasm-Modul mit aktivierten JavaScript-String-Builtins und importierten globalen String-Konstanten und loggt "Wasm module valid: true" in die Konsole, wenn es gltig ist, und "Wasm module valid: false", wenn es nicht gltig ist. Sehen Sie es live.

const compileOptions = {
  builtins: ["js-string"], // Enable JavaScript string builtins
  importedStringConstants: "string_constants", // Enable imported global string constants
};

fetch("log-concat.wasm")
  .then((response) => response.arrayBuffer())
  .then((bytes) => WebAssembly.validate(bytes, compileOptions))
  .then((result) => console.log(`Wasm module valid: ${result}`));

Spezifikationen

Browser-Kompatibilitt

Siehe auch

• berblick ber WebAssembly
• Konzepte von WebAssembly
• Verwendung der WebAssembly JavaScript API