FinalizationRegistry: missing example and lack of clarity on "threads"

[audetto]

MDN URL

https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/FinalizationRegistry

What specific section or headline is this issue about?

Notes on cleanup callbacks

What information was incorrect, unhelpful, or incomplete?

The documentation does not say anything about the thread that will run the callbacks.

It is very important because until the main thread "yields", they cannot run. And if the main thread never yields, they can only run at the end.
This has been confirmed both in node and deno.

Basically, without repeated calls to setTimeout, the callbacks never run.

I think it is a fundamental piece of information, even considering all the disclaimers.

What did you expect to see?

1. information about the need of some sort of pause in the main thread
2. a complete example

Do you have any supporting links, references, or citations?

https://github.com/orgs/nodejs/discussions/47716

Do you have anything more you want to share?

No response

MDN metadata

Page report details

• Folder: en-us/web/javascript/reference/global_objects/finalizationregistry
• MDN URL: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/FinalizationRegistry
• GitHub URL: https://github.com/mdn/content/blob/main/files/en-us/web/javascript/reference/global_objects/finalizationregistry/index.md
• Last commit: 7da0dab
• Document last modified: 2023-03-29T16:29:26.000Z