WebAssembly.Tag

WebAssembly.Tag对象定义了一个WebAssembly异常的类型，该异常可以从 WebAssembly 代码中抛出。

When creating aWebAssembly.Exception, the tag defines the data types and order of the values carried by the exception. The same unique tag instance must be used to access the values of the exception(for example, when usingException.prototype.getArg()).

Constructing an instance ofTagcreates a new unique tag. This tag can be passed to a WebAssembly module as a tag import, where it will become a typed tag defined in thetag sectionof the WebAssembly module. You can also export a tag defined in a module and use it to inspect exceptions thrown from the module.

Note: You can't access the values of an exception with a new tag that just happens to have the same parameters; it's a different tag! This ensures that WebAssembly modules can keep exception information internal if required. Code can still catch and rethrow exceptions that it does not understand.

Constructor

Creates a newWebAssembly.Tagobject.

Instance methods

Returns the object defining the data-types array for the tag(as set in its constructor).

Examples

This code snippet creates a newTaginstance.

const tagToImport = new WebAssembly.Tag({ parameters: ["i32", "f32"] });

The snippet below shows how we might pass it to a module example.wasm during instantiation, using an "import object".

const importObject = {
  extmod: {
    exttag: tagToImport,
  },
};

WebAssembly.instantiateStreaming(fetch("example.wasm"), importObject).then(
  (obj) => {
    // …
  }
);

The WebAssembly module might then import the tag as shown below:

(module
  (import "extmod" "exttag" (tag $tagname (param i32 f32))
)

If the tag was used to throw an exception that propagated to JavaScript, we could use the tag to inspect its values.

Note: There are many alternatives. We could also use the tag to create aWebAssembly.Exceptionand throw that from a function called by WebAssembly.