Skip to content

doc, async_hooks: improve and add migration hints

Rodrigo Muino Tomonari requested to merge github/fork/Flarna/doc-async-hooks into main

Add hints to migrate away from async hooks. Change docs at various places to be more clear that resources are internals and may change at any time.

This might replace and/or extend #45335.

Main differences (besides the few additions):

  • don't announce the We plan to remove this API
  • don't refer to diagnostics_channel because I'm not aware of any async hooks use case which is solved by diagnostics_channel (well, we could create async.init, async.before, async.after and async.destroy channels to hide async hooks API but this would be of no real help)

I think it's easier to provide my view/input via a new PR. Anyhow, if people prefer the wording/message of #45335 I'm also fine and will close this one.

Refs: #45335

fyi @GeoffreyBooth @nodejs/diagnostics

Merge request reports