Reference for stage 3 explicit-resource-management

[Josh-Cena]

Just to show that I know about its existence and it's being worked on. There's no proposed timeline.

This is ready for review. It's a big API, but overall there are the following parts to review:

1. Look at the guide. It provides an overview of the API which you can use as a roadmap.
2. Look at using and await using.
3. Look at DisposableStack and AsyncDisposableStack.
4. Look at Symbol.dispose and Symbol.asyncDispose.
5. Look at all other pages where I made sporadic changes.

Fixes #39474

[github-actions]

Preview URLs (43 pages)

• /en-US/docs/Web/JavaScript/Guide/Internationalization
• /en-US/docs/Web/JavaScript/Guide/Iterators_and_generators
• /en-US/docs/Web/JavaScript/Guide/Resource_management
• /en-US/docs/Web/JavaScript/Reference/Global_Objects/AsyncDisposableStack/AsyncDisposableStack
• /en-US/docs/Web/JavaScript/Reference/Global_Objects/AsyncDisposableStack/Symbol.asyncDispose
• /en-US/docs/Web/JavaScript/Reference/Global_Objects/AsyncDisposableStack/adopt
• /en-US/docs/Web/JavaScript/Reference/Global_Objects/AsyncDisposableStack/defer
• /en-US/docs/Web/JavaScript/Reference/Global_Objects/AsyncDisposableStack/disposeAsync
• /en-US/docs/Web/JavaScript/Reference/Global_Objects/AsyncDisposableStack/disposed
• /en-US/docs/Web/JavaScript/Reference/Global_Objects/AsyncDisposableStack/move
• /en-US/docs/Web/JavaScript/Reference/Global_Objects/AsyncDisposableStack/use
• /en-US/docs/Web/JavaScript/Reference/Global_Objects/AsyncDisposableStack
• /en-US/docs/Web/JavaScript/Reference/Global_Objects/AsyncIterator/Symbol.asyncDispose
• /en-US/docs/Web/JavaScript/Reference/Global_Objects/AsyncIterator
• /en-US/docs/Web/JavaScript/Reference/Global_Objects/DisposableStack/DisposableStack
• /en-US/docs/Web/JavaScript/Reference/Global_Objects/DisposableStack/Symbol.dispose
• /en-US/docs/Web/JavaScript/Reference/Global_Objects/DisposableStack/adopt
• /en-US/docs/Web/JavaScript/Reference/Global_Objects/DisposableStack/defer
• /en-US/docs/Web/JavaScript/Reference/Global_Objects/DisposableStack/dispose
• /en-US/docs/Web/JavaScript/Reference/Global_Objects/DisposableStack/disposed
• /en-US/docs/Web/JavaScript/Reference/Global_Objects/DisposableStack/move
• /en-US/docs/Web/JavaScript/Reference/Global_Objects/DisposableStack/use
• /en-US/docs/Web/JavaScript/Reference/Global_Objects/DisposableStack
• /en-US/docs/Web/JavaScript/Reference/Global_Objects/Iterator/Symbol.dispose
• /en-US/docs/Web/JavaScript/Reference/Global_Objects/Iterator
• /en-US/docs/Web/JavaScript/Reference/Global_Objects/SuppressedError/SuppressedError
• /en-US/docs/Web/JavaScript/Reference/Global_Objects/SuppressedError/error
• /en-US/docs/Web/JavaScript/Reference/Global_Objects/SuppressedError/suppressed
• /en-US/docs/Web/JavaScript/Reference/Global_Objects/SuppressedError
• /en-US/docs/Web/JavaScript/Reference/Global_Objects/Symbol/asyncDispose
• /en-US/docs/Web/JavaScript/Reference/Global_Objects/Symbol/dispose
• /en-US/docs/Web/JavaScript/Reference/Global_Objects/Symbol
• /en-US/docs/Web/JavaScript/Reference/Global_Objects
• /en-US/docs/Web/JavaScript/Reference/Lexical_grammar
• /en-US/docs/Web/JavaScript/Reference/Statements/await_using
• /en-US/docs/Web/JavaScript/Reference/Statements/block
• /en-US/docs/Web/JavaScript/Reference/Statements/export
• /en-US/docs/Web/JavaScript/Reference/Statements/for-await...of
• /en-US/docs/Web/JavaScript/Reference/Statements/for...in
• /en-US/docs/Web/JavaScript/Reference/Statements/for...of
• /en-US/docs/Web/JavaScript/Reference/Statements/using
• /en-US/docs/Web/JavaScript/Reference/Statements
• /en-US/docs/Web/JavaScript/Reference

External URLs (15)

URL: /en-US/docs/Web/JavaScript/Guide/Resource_management
Title: JavaScript resource management

• https://github.com/typescript-eslint/typescript-eslint/issues/8255 (1 time) (Note! This may be a new URL 👀)
• https://nodejs.org/api/fs.html (1 time) (Note! This may be a new URL 👀)
• https://typescript-eslint.io/ (1 time) (Note! This may be a new URL 👀)

---

URL: /en-US/docs/Web/JavaScript/Reference/Global_Objects/AsyncDisposableStack
Title: AsyncDisposableStack

• https://github.com/zloirock/core-js (1 time) (Note! This may be a new URL 👀)

---

URL: /en-US/docs/Web/JavaScript/Reference/Global_Objects/AsyncDisposableStack/adopt
Title: AsyncDisposableStack.prototype.adopt()

• https://nodejs.org/api/fs.html (1 time) (Note! This may be a new URL 👀)

---

URL: /en-US/docs/Web/JavaScript/Reference/Global_Objects/AsyncDisposableStack/use
Title: AsyncDisposableStack.prototype.use()

• https://nodejs.org/api/fs.html (1 time) (Note! This may be a new URL 👀)

---

URL: /en-US/docs/Web/JavaScript/Reference/Global_Objects/AsyncIterator/Symbol.asyncDispose
Title: AsyncIterator.prototype[Symbol.asyncDispose]()

• https://github.com/zloirock/core-js (1 time) (Note! This may be a new URL 👀)

---

URL: /en-US/docs/Web/JavaScript/Reference/Global_Objects/DisposableStack
Title: DisposableStack

• https://github.com/zloirock/core-js (1 time) (Note! This may be a new URL 👀)

---

URL: /en-US/docs/Web/JavaScript/Reference/Global_Objects/Iterator/Symbol.dispose
Title: Iterator.prototype[Symbol.dispose]()

• https://github.com/zloirock/core-js (1 time) (Note! This may be a new URL 👀)

---

URL: /en-US/docs/Web/JavaScript/Reference/Global_Objects/SuppressedError
Title: SuppressedError

• https://github.com/zloirock/core-js (1 time) (Note! This may be a new URL 👀)

---

URL: /en-US/docs/Web/JavaScript/Reference/Global_Objects/SuppressedError/SuppressedError
Title: SuppressedError() constructor

• https://github.com/zloirock/core-js (1 time) (Note! This may be a new URL 👀)

---

URL: /en-US/docs/Web/JavaScript/Reference/Global_Objects/Symbol/asyncDispose
Title: Symbol.asyncDispose

• https://github.com/zloirock/core-js (1 time) (Note! This may be a new URL 👀)

---

URL: /en-US/docs/Web/JavaScript/Reference/Global_Objects/Symbol/dispose
Title: Symbol.dispose

• https://github.com/zloirock/core-js (1 time) (Note! This may be a new URL 👀)

---

URL: /en-US/docs/Web/JavaScript/Reference/Statements/await_using
Title: await using

• https://nodejs.org/api/fs.html (2 times) (Note! This may be a new URL 👀)

---

URL: /en-US/docs/Web/JavaScript/Reference/Statements/using
Title: using

• https://en.wikipedia.org/wiki/Resource_acquisition_is_initialization (1 time) (Note! This may be a new URL 👀)

(comment last updated: 2025-07-29 03:26:45)

[github-actions]

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

[Josh-Cena]

@rbuckton it would be very great if you could provide a technical review of this content. Thank you!

[github-actions]

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

[Josh-Cena]

Thanks everyone! Really appreciate the reviews. Merging shortly and letting everyone enjoy ERM :)