lib: add abortSignal.throwIfAborted()

Refs: https://github.com/whatwg/dom/pull/1034
Signed-off-by: James M Snell <jasnell@gmail.com>

PR-URL: https://github.com/nodejs/node/pull/40951
Reviewed-By: Benjamin Gruenbaum <benjamingr@gmail.com>

1 files changed, 8 insertions, 0 deletions

diff --git a/doc/api/globals.md b/doc/api/globals.md
index 3e47237714f..9df487a786a 100644
--- a/doc/api/globals.md
+++ b/doc/api/globals.md
@@ -191,6 +191,14 @@ ac.abort(new Error('boom!'));
 console.log(ac.signal.reason);  // Error('boom!');
 ```
 
+#### `abortSignal.throwIfAborted()`
+
+<!-- YAML
+added: REPLACEME
+-->
+
+If `abortSignal.aborted` is `true`, throws `abortSignal.reason`.
+
 ## Class: `Buffer`
 
 <!-- YAML