Skip to content

docs: documenting async hooks features #13287

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
AndreasMadsen wants to merge 18 commits into from
Closed

docs: documenting async hooks features #13287

Changes from 1 commit
Commits
Show all changes
18 commits
Select commit Hold shift + click to select a range
59088f3
docs: async-hooks documentation
thlorenz Nov 28, 2016
1e35d73
[squash] addressing nits pointed out by Trevor
thlorenz Feb 7, 2017
c5db0a6
[squash] renaming Number to number
thlorenz May 10, 2017
3218d31
[squash] addressing simple nits
thlorenz May 18, 2017
aa830d7
[squash] remove standalone JS Embedder API docs
AndreasMadsen May 26, 2017
d09735f
[squash] AsyncEvent is renamed to AsyncResource
AndreasMadsen May 26, 2017
fa37457
[squash] use fs.writeSync and describe issue and solution
AndreasMadsen May 29, 2017
9b9cc15
[squash] async-hooks -> async_hooks
AndreasMadsen May 29, 2017
affa7a7
[squash] addaleax sugestions
AndreasMadsen May 29, 2017
1f23ab2
[squash] jasnell sugestions
AndreasMadsen May 29, 2017
47a51c1
[squash] id => ID
AndreasMadsen May 29, 2017
9864609
[squash] sam-github suggesions
AndreasMadsen May 29, 2017
de40c74
[squash] document resource object and its limitations
AndreasMadsen May 29, 2017
7c9ecd4
[squash] more sam-github suggesions
AndreasMadsen May 29, 2017
de82ef4
[squash] fix typos + make linter pass
addaleax May 29, 2017
d3ee97e
[squash] fix internal link
AndreasMadsen May 29, 2017
4ba706f
[squash] mikesherov suggesion
AndreasMadsen May 30, 2017
82149a8
[squash] trevnorris suggestions
AndreasMadsen Jun 1, 2017
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Prev Previous commit
Next Next commit
[squash] addressing nits pointed out by Trevor
  • Loading branch information
@thlorenz @AndreasMadsen
thlorenz authored and AndreasMadsen committed May 29, 2017
commit 1e35d734295e8dbf07fb22c995970bcf424cd27d
16 changes: 10 additions & 6 deletions doc/api/async_hooks.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,15 +1,12 @@
# Async Hooks


> Stability: 2 - Stable
> Stability: 1 - Experimental


The `async-hooks` module provides an API to register callbacks tracking the
lifetime of asynchronous resources created inside a Node.js application.

At its simplest form it can track metadata about each resource and log it when
the program exits.

## Terminology

An async resource represents either a "handle" or a "request".
Expand Down Expand Up @@ -249,19 +246,26 @@ Output from only starting the server:

```
TCPWRAP(2): trigger: 1 scope: 1
# .listen()
TickObject(3): trigger: 1 scope: 1
TickObject(3): trigger: 2 scope: 1
before: 3
Timeout(4): trigger: 3 scope: 3
TIMERWRAP(5): trigger: 3 scope: 3
after: 3
destroy: 3
before: 5
before: 4
TTYWRAP(6): trigger: 4 scope: 4
SIGNALWRAP(7): trigger: 4 scope: 4
TTYWRAP(8): trigger: 4 scope: 4
>>> 4
TickObject(9): trigger: 4 scope: 4
after: 4
destroy: 4
after: 5
before: 9
after: 9
destroy: 9
destroy: 5
```

First notice that `scope` and the value returned by `currentId()` are always
Expand Down