WebAssembly.Table.prototype.get()
BaselineWidely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since October 2017.
Theget()
prototype method of theWebAssembly.Table()
object retrieves the element stored at a given index.
Syntax
get(index)
Parameters
index
The index of the element you want to retrieve.
Return value
Depending the element type of the Table, can be a function reference — this is anexported WebAssembly function, a JavaScript wrapper for an underlying Wasm function, or it can be a host reference.
Exceptions
Ifindex is greater than or equal toTable.prototype.length
, aRangeError
is thrown.
Examples
Using get
The following example (seetable.html on GitHub, andview it live also) compiles and instantiates the loaded table.wasm byte code using theWebAssembly.instantiateStreaming()
method. It then retrieves the references stored in the exported table.
WebAssembly.instantiateStreaming(fetch("table.wasm")).then((obj) => { const tbl = obj.instance.exports.tbl; console.log(tbl.get(0)()); // 13 console.log(tbl.get(1)()); // 42});
Note how you've got to include a second function invocation operator at the end of the accessor to actually retrieve the value stored inside the reference (e.g.,get(0)()
rather thanget(0)
) — it is a function rather than a simple value.
Specifications
Specification |
---|
WebAssembly JavaScript Interface # dom-table-get |