Commit a25d76c
doc: recommend events.once to manage 'close' event
`events.once` is a great way to manage the `close` / `error` / `exit`
events of a child process. It creates a Promise that is fulfilled when
the EventEmitter emits the given event or that is rejected if the
EventEmitter emits 'error' while waiting.
I think a lot of people wrongly think that managing a spawned child
process requires writing boilerplate handlers for `close` and `error`,
and that there's no `promisify` solution for spawned child processes. In
fact, `events.once` is that solution. The docs should explicitly
recommend it in examples.
PR-URL: #60017
Reviewed-By: Chemi Atlow <chemi@atlow.co.il>1 parent 795f32b commit a25d76cCopy full SHA for a25d76c
File tree
Expand file treeCollapse file tree
1 file changed
+10
-6
lines changedOpen diff view settings
Filter options
- doc/api
Expand file treeCollapse file tree
1 file changed
+10
-6
lines changedOpen diff view settings
Collapse file
+10-6Lines changed: 10 additions & 6 deletions
- Display the source diff
- Display the rich diff
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| ||
29 | 29 | |
30 | 30 | |
31 | 31 | |
| 32 | + |
32 | 33 | |
33 | 34 | |
34 | 35 | |
| ||
39 | 40 | |
40 | 41 | |
41 | 42 | |
42 | | - |
43 | | - |
44 | | - |
| 43 | + |
| 44 | + |
45 | 45 | |
46 | 46 | |
47 | 47 | |
| ||
772 | 772 | |
773 | 773 | |
774 | 774 | |
| 775 | + |
775 | 776 | |
776 | 777 | |
777 | 778 | |
| ||
782 | 783 | |
783 | 784 | |
784 | 785 | |
785 | | - |
786 | | - |
787 | | - |
| 786 | + |
| 787 | + |
788 | 788 | |
789 | 789 | |
790 | 790 | |
| ||
1483 | 1483 | |
1484 | 1484 | |
1485 | 1485 | |
| 1486 | + |
1486 | 1487 | |
1487 | 1488 | |
1488 | 1489 | |
| ||
1496 | 1497 | |
1497 | 1498 | |
1498 | 1499 | |
| 1500 | + |
| 1501 | + |
| 1502 | + |
1499 | 1503 | |
1500 | 1504 | |
1501 | 1505 | |
|
0 commit comments