diff --git a/doc/api/globals.md b/doc/api/globals.md index da86cada230092..e92dd5fc47d732 100644 --- a/doc/api/globals.md +++ b/doc/api/globals.md @@ -89,11 +89,15 @@ ac.abort(); ``` The `AbortController` with which the `AbortSignal` is associated will only -ever trigger the `'abort'` event once. Any event listeners attached to the -`AbortSignal` *should* use the `{ once: true }` option (or, if using the -`EventEmitter` APIs to attach a listener, use the `once()` method) to ensure -that the event listener is removed as soon as the `'abort'` event is handled. -Failure to do so may result in memory leaks. +ever trigger the `'abort'` event once. We recommended that code check +that the `abortSignal.aborted` attribute is `false` before adding an `'abort'` +event listener. + +Any event listeners attached to the `AbortSignal` should use the +`{ once: true }` option (or, if using the `EventEmitter` APIs to attach a +listener, use the `once()` method) to ensure that the event listener is +removed as soon as the `'abort'` event is handled. Failure to do so may +result in memory leaks. #### `abortSignal.aborted`