Fix multiple issues with FinalizationRegistry content

[Josh-Cena]

Summary

Motivation

Fix #13695

Supporting details

Related issues

Metadata

• Adds a new document
• Rewrites (or significantly expands) a document
• Fixes a typo, bug, or other error

[github-actions]

Preview URLs

• https://pr17126.content.dev.mdn.mozit.cloud/en-US/docs/Web/JavaScript/Reference/Global_Objects/FinalizationRegistry/register
• https://pr17126.content.dev.mdn.mozit.cloud/en-US/docs/Web/JavaScript/Reference/Global_Objects/FinalizationRegistry/unregister
• https://pr17126.content.dev.mdn.mozit.cloud/en-US/docs/Web/JavaScript/Reference/Global_Objects/FinalizationRegistry

Flaws

None! 🎉

External URLs

URL: /en-US/docs/Web/JavaScript/Reference/Global_Objects/FinalizationRegistry
Title: FinalizationRegistry
on GitHub

No new external URLs

---

URL: /en-US/docs/Web/JavaScript/Reference/Global_Objects/FinalizationRegistry/register
Title: FinalizationRegistry.prototype.register()
on GitHub

No new external URLs

---

URL: /en-US/docs/Web/JavaScript/Reference/Global_Objects/FinalizationRegistry/unregister
Title: FinalizationRegistry.prototype.unregister()
on GitHub

No new external URLs

(this comment was updated 2022-06-10 05:33:13.915514)

[teoli2003]

Thanks a lot.

I think there are extra things that should be updated. What do you think?

[teoli2003]

In addition to the boolean value, I think there are cases where undefined can be returned, am I wrong?

[Josh-Cena]

Can't find it in spec. It either returns a boolean, or throws a TypeError.

[teoli2003]

I think we have cases where the {{jsxref("TypeError")}} exception is raised. We likely want an ### Exceptions section.

[Josh-Cena]

Makes sense—when I work on these docs there are a lot of sections missing mentions of exceptions. Is there a convention for how this should be structured? Or just an h3 section.

[teoli2003]

Yes, we should add them as we do for API, with a definition list in that section: https://developer.mozilla.org/en-US/docs/MDN/Structures/Page_types/API_method_subpage_template#exceptions

Something like: https://developer.mozilla.org/en-US/docs/Web/API/IDBCursor/continue#exceptions

And yes, there are a lot of exceptions not listed (both under JS and API), I would like to make a full check once, but I don't have the time. Getting the exception list, with causes, complete under JavaScript/ and API/ is hard, though as they are buried inside the prose, or the algorithm, of the specifications.

[teoli2003]

Thank you very much. I've listed the three conditions for an exception as a list (we usually do this).

Let's merge this. If we discover more problems we always can fix them in follow-ups!