WebAssembly | Table - add undocumented details and update for externref

[ghost]

Description

Removes indications that WebAssembly.Table only handles functions.

Add undocumented details from the core specification that were not previous present.

Motivation

Keeping documentation up-to-date.

[github-actions]

Preview URLs (6 pages)

• /en-US/docs/WebAssembly/JavaScript_interface/Table/Table
• /en-US/docs/WebAssembly/JavaScript_interface/Table/get
• /en-US/docs/WebAssembly/JavaScript_interface/Table/grow
• /en-US/docs/WebAssembly/JavaScript_interface/Table/length
• /en-US/docs/WebAssembly/JavaScript_interface/Table/set
• /en-US/docs/WebAssembly/JavaScript_interface/Table

External URLs (4)

URL: /en-US/docs/WebAssembly/JavaScript_interface/Table/Table
Title: WebAssembly.Table() constructor

• https://mdn.github.io/webassembly-examples/js-api-examples/table2.html (1 time) (Note! This may be a new URL 👀)
• https://webassembly.github.io/spec/core/syntax/types.html (1 time) (Note! This may be a new URL 👀)

---

URL: /en-US/docs/WebAssembly/JavaScript_interface/Table/get
Title: WebAssembly.Table.prototype.get()

• https://mdn.github.io/webassembly-examples/js-api-examples/table.html (1 time) (Note! This may be a new URL 👀)

---

URL: /en-US/docs/WebAssembly/JavaScript_interface/Table/set
Title: WebAssembly.Table.prototype.set()

• https://mdn.github.io/webassembly-examples/js-api-examples/table2.html (1 time) (Note! This may be a new URL 👀)

(comment last updated: 2023-10-27 04:49:05)

[Josh-Cena]

Suggested change

	- {{jsxref("RangeError")}}: If the current size added with `elementIncrease` exceeds the Table instance's maximum size capacity.
	- {{jsxref("TypeError")}}: If `value` is not a value of the element type of the table.
	- {{jsxref("RangeError")}}: If there is insufficient memory.
	- {{jsxref("RangeError")}}
	- : Thrown in one of the following cases:
	- If the current size added with `elementIncrease` exceeds the Table instance's maximum size capacity.
	- If there is insufficient memory.
	- {{jsxref("TypeError")}}
	- : Thrown if `value` is not a value of the element type of the table.

...aren't the two RangeError conditions talking about the same thing, anyway?

[ghost]

...aren't the two RangeError conditions talking about the same thing, anyway?

No. Consider a Table that doesn't have a set maximum capacity. It's the difference between the artificial check with respect to the array bounds, versus the user agent/client running out of RAM or page memory, or anything of that sort. You can set the maximum size to (2^32 - 1), but might not be able to reach that size in reality. The maximum is just an artificial preset cap, but the memory may not necessarily be pre-allocated.

I can attempt to tersely work this into the error explanations.

[ghost]

@Josh-Cena Please confirm that the proceeding commit has appropriately settled any confusion regarding this.

[ghost]

@bsmth @Josh-Cena It's been a while - can I get another review here?

[Josh-Cena]

Since this contains non-editorial content changes, it's better to get @bsmth to look at this since I can't claim to be familiar with Wasm docs.

[ghost]

Ah, understood.

[github-actions]

This pull request has merge conflicts that must be resolved before it can be merged.

[bsmth]

Super @vimirage - I've no other suggestions, so leaving a +1 and merging shortly. Thank you 👍🏻

[ghost]

lol I didn't use delta everywhere.

I'll do that within 24h and tag you in the PR, if you're okay with that.

[bsmth]

I didn't use delta everywhere.

I'll do that within 24h and tag you in the PR, if you're okay with that.

No problem, I'm happy to have a look then.