doc: add differences from standard fetch in fetch() API

Author: Khan30-ai

doc/api/globals.md

@@ -11,11 +11,11 @@ These objects are available in all modules.
 The following variables may appear to be global but are not. They exist only in
 the scope of [CommonJS modules][]:
 
-* [`__dirname`][]
-* [`__filename`][]
-* [`exports`][]
-* [`module`][]
-* [`require()`][]
+- [`__dirname`][]
+- [`__filename`][]
+- [`exports`][]
+- [`module`][]
+- [`require()`][]
 
 The objects listed here are specific to Node.js. There are [built-in objects][]
 that are part of the JavaScript language itself, which are also globally
@@ -39,12 +39,13 @@ The API is based on the Web API {AbortController}.
 ```js
 const ac = new AbortController();
 
-ac.signal.addEventListener('abort', () => console.log('Aborted!'),
-                           { once: true });
+ac.signal.addEventListener('abort', () => console.log('Aborted!'), {
+  once: true,
+});
 
 ac.abort();
 
-console.log(ac.signal.aborted);  // Prints true
+console.log(ac.signal.aborted); // Prints true
 ```
 
 ### `abortController.abort([reason])`
@@ -61,7 +62,7 @@ changes:
     description: Added the new optional reason argument.
 -->
 
-* `reason` {any} An optional reason, retrievable on the `AbortSignal`'s
+- `reason` {any} An optional reason, retrievable on the `AbortSignal`'s
   `reason` property.
 
 Triggers the abort signal, causing the `abortController.signal` to emit
@@ -75,7 +76,7 @@ added:
   - v14.17.0
 -->
 
-* Type: {AbortSignal}
+- Type: {AbortSignal}
 
 ### Class: `AbortSignal`
 
@@ -85,7 +86,7 @@ added:
   - v14.17.0
 -->
 
-* Extends: {EventTarget}
+- Extends: {EventTarget}
 
 The `AbortSignal` is used to notify observers when the
 `abortController.abort()` method is called.
@@ -104,8 +105,8 @@ changes:
     description: Added the new optional reason argument.
 -->
 
-* `reason` {any}
-* Returns: {AbortSignal}
+- `reason` {any}
+- Returns: {AbortSignal}
 
 Returns a new already aborted `AbortSignal`.
 
@@ -117,7 +118,7 @@ added:
   - v16.14.0
 -->
 
-* `delay` {number} The number of milliseconds to wait before triggering
+- `delay` {number} The number of milliseconds to wait before triggering
   the AbortSignal.
 
 Returns a new `AbortSignal` which will be aborted in `delay` milliseconds.
@@ -130,7 +131,7 @@ added:
   - v18.17.0
 -->
 
-* `signals` {AbortSignal\[]} The `AbortSignal`s of which to compose a new `AbortSignal`.
+- `signals` {AbortSignal\[]} The `AbortSignal`s of which to compose a new `AbortSignal`.
 
 Returns a new `AbortSignal` which will be aborted if any of the provided
 signals are aborted. Its [`abortSignal.reason`][] will be set to whichever
@@ -155,9 +156,13 @@ const ac = new AbortController();
 ac.signal.onabort = () => console.log('aborted!');
 
 // Or the EventTarget API...
-ac.signal.addEventListener('abort', (event) => {
-  console.log(event.type);  // Prints 'abort'
-}, { once: true });
+ac.signal.addEventListener(
+  'abort',
+  (event) => {
+    console.log(event.type); // Prints 'abort'
+  },
+  { once: true }
+);
 
 ac.abort();
 ```
@@ -181,7 +186,7 @@ added:
   - v14.17.0
 -->
 
-* Type: {boolean} True after the `AbortController` has been aborted.
+- Type: {boolean} True after the `AbortController` has been aborted.
 
 #### `abortSignal.onabort`
 
@@ -191,7 +196,7 @@ added:
   - v14.17.0
 -->
 
-* Type: {Function}
+- Type: {Function}
 
 An optional callback function that may be set by user code to be notified
 when the `abortController.abort()` function has been called.
@@ -204,14 +209,14 @@ added:
   - v16.14.0
 -->
 
-* Type: {any}
+- Type: {any}
 
 An optional reason specified when the `AbortSignal` was triggered.
 
 ```js
 const ac = new AbortController();
 ac.abort(new Error('boom!'));
-console.log(ac.signal.reason);  // Error: boom!
+console.log(ac.signal.reason); // Error: boom!
 ```
 
 #### `abortSignal.throwIfAborted()`
@@ -238,7 +243,7 @@ See {Blob}.
 added: v0.1.103
 -->
 
-* Type: {Function}
+- Type: {Function}
 
 Used to handle binary data. See the [buffer section][].
 
@@ -348,7 +353,7 @@ A browser-compatible implementation of [`CompressionStream`][].
 added: v0.1.100
 -->
 
-* Type: {Object}
+- Type: {Object}
 
 Used to print to stdout and stderr. See the [`console`][] section.
 
@@ -541,6 +546,15 @@ The implementation is based upon [undici](https://undici.nodejs.org), an HTTP/1.
 written from scratch for Node.js. You can figure out which version of `undici` is bundled
 in your Node.js process reading the `process.versions.undici` property.
 
+### Differences from standard fetch
+
+Node.js provides a `fetch()` implementation that is similar to the web standard but with a few notable differences:
+
+- `new Response(asyncIterable)` is supported, which is not in the standard.
+- Cookies are not automatically handled.
+- The forbidden headers list is not enforced.
+- Other subtle differences may exist; consult the implementation details.
+
 ### Custom dispatcher
 
 You can use a custom dispatcher to dispatch requests passing it in fetch's options object.
@@ -564,10 +578,10 @@ setGlobalDispatcher(new MyAgent());
 
 The following globals are available to use with `fetch`:
 
-* [`FormData`](https://nodejs.org/api/globals.html#class-formdata)
-* [`Headers`](https://nodejs.org/api/globals.html#class-headers)
-* [`Request`](https://nodejs.org/api/globals.html#request)
-* [`Response`](https://nodejs.org/api/globals.html#response).
+- [`FormData`](https://nodejs.org/api/globals.html#class-formdata)
+- [`Headers`](https://nodejs.org/api/globals.html#class-headers)
+- [`Request`](https://nodejs.org/api/globals.html#request)
+- [`Response`](https://nodejs.org/api/globals.html#response).
 
 ## Class: `File`
 
@@ -603,7 +617,7 @@ added: v0.1.27
 
 > Stability: 3 - Legacy. Use [`globalThis`][] instead.
 
-* Type: {Object} The global namespace object.
+- Type: {Object} The global namespace object.
 
 In browsers, the top-level scope has traditionally been the global scope. This
 means that `var something` will define a new global variable, except within
@@ -702,13 +716,15 @@ A partial implementation of [`window.navigator`][].
 added: v21.0.0
 -->
 
-* Type: {number}
+- Type: {number}
 
 The `navigator.hardwareConcurrency` read-only property returns the number of
 logical processors available to the current Node.js instance.
 
 ```js
-console.log(`This process is running on ${navigator.hardwareConcurrency} logical processors`);
+console.log(
+  `This process is running on ${navigator.hardwareConcurrency} logical processors`
+);
 ```
 
 ### `navigator.language`
@@ -717,7 +733,7 @@ console.log(`This process is running on ${navigator.hardwareConcurrency} logical
 added: v21.2.0
 -->
 
-* Type: {string}
+- Type: {string}
 
 The `navigator.language` read-only property returns a string representing the
 preferred language of the Node.js instance. The language will be determined by
@@ -729,7 +745,9 @@ The value is representing the language version as defined in [RFC 5646][].
 The fallback value on builds without ICU is `'en-US'`.
 
 ```js
-console.log(`The preferred language of the Node.js instance has the tag '${navigator.language}'`);
+console.log(
+  `The preferred language of the Node.js instance has the tag '${navigator.language}'`
+);
 ```
 
 ### `navigator.languages`
@@ -738,7 +756,7 @@ console.log(`The preferred language of the Node.js instance has the tag '${navig
 added: v21.2.0
 -->
 
-* Type: {Array<string>}
+- Type: {Array<string>}
 
 The `navigator.languages` read-only property returns an array of strings
 representing the preferred languages of the Node.js instance.
@@ -758,7 +776,7 @@ console.log(`The preferred languages are '${navigator.languages}'`);
 added: v21.2.0
 -->
 
-* Type: {string}
+- Type: {string}
 
 The `navigator.platform` read-only property returns a string identifying the
 platform on which the Node.js instance is running.
@@ -773,7 +791,7 @@ console.log(`This process is running on ${navigator.platform}`);
 added: v21.1.0
 -->
 
-* Type: {string}
+- Type: {string}
 
 The `navigator.userAgent` read-only property returns user agent
 consisting of the runtime name and major version number.
@@ -804,29 +822,37 @@ await navigator.locks.request('my_resource', async (lock) => {
 });
 
 // Request a shared lock
-await navigator.locks.request('shared_resource', { mode: 'shared' }, async (lock) => {
-  // Multiple shared locks can be held simultaneously
-  console.log(`Shared lock acquired: ${lock.name}`);
-});
+await navigator.locks.request(
+  'shared_resource',
+  { mode: 'shared' },
+  async (lock) => {
+    // Multiple shared locks can be held simultaneously
+    console.log(`Shared lock acquired: ${lock.name}`);
+  }
+);
 ```
 
 ```cjs
 // Request an exclusive lock
-navigator.locks.request('my_resource', async (lock) => {
-  // The lock has been acquired.
-  console.log(`Lock acquired: ${lock.name}`);
-  // Lock is automatically released when the function returns
-}).then(() => {
-  console.log('Lock released');
-});
+navigator.locks
+  .request('my_resource', async (lock) => {
+    // The lock has been acquired.
+    console.log(`Lock acquired: ${lock.name}`);
+    // Lock is automatically released when the function returns
+  })
+  .then(() => {
+    console.log('Lock released');
+  });
 
 // Request a shared lock
-navigator.locks.request('shared_resource', { mode: 'shared' }, async (lock) => {
-  // Multiple shared locks can be held simultaneously
-  console.log(`Shared lock acquired: ${lock.name}`);
-}).then(() => {
-  console.log('Shared lock released');
-});
+navigator.locks
+  .request('shared_resource', { mode: 'shared' }, async (lock) => {
+    // Multiple shared locks can be held simultaneously
+    console.log(`Shared lock acquired: ${lock.name}`);
+  })
+  .then(() => {
+    console.log('Shared lock released');
+  });
 ```
 
 See [`worker.locks`][] for detailed API documentation.
@@ -895,7 +921,7 @@ The [`perf_hooks.performance`][] object.
 added: v0.1.7
 -->
 
-* Type: {Object}
+- Type: {Object}
 
 The process object. See the [`process` object][] section.
 
@@ -905,7 +931,7 @@ The process object. See the [`process` object][] section.
 added: v11.0.0
 -->
 
-* `callback` {Function} Function to be queued.
+- `callback` {Function} Function to be queued.
 
 The `queueMicrotask()` method queues a microtask to invoke `callback`. If
 `callback` throws an exception, the [`process` object][] `'uncaughtException'`
@@ -1244,7 +1270,7 @@ The WHATWG `URLSearchParams` class. See the [`URLSearchParams`][] section.
 added: v8.0.0
 -->
 
-* Type: {Object}
+- Type: {Object}
 
 The object that acts as the namespace for all W3C
 [WebAssembly][webassembly-org] related functionality. See the