Commit 329497afb56 for nodejs

commit 329497afb56e7f5c36ea1b820bb55c07ab733858
Author: LiviaMedeiros <livia@cirno.name>
Date:   Sat Nov 14 07:28:46 2026 +0800

    doc: swap `util.TextDecoder` and `util.TextEncoder` with globals

    Signed-off-by: LiviaMedeiros <livia@cirno.name>
    PR-URL: https://github.com/nodejs/node/pull/67461
    Reviewed-By: Aviv Keller <me@aviv.sh>
    Reviewed-By: James M Snell <jasnell@gmail.com>
    Reviewed-By: Antoine du Hamel <duhamelantoine1995@gmail.com>
    Reviewed-By: Filip Skokan <panva.ip@gmail.com>
    Reviewed-By: Gürgün Dayıoğlu <hey@gurgun.day>

diff --git a/doc/api/globals.md b/doc/api/globals.md
index 15a741a242f..141d870c3a9 100644
--- a/doc/api/globals.md
+++ b/doc/api/globals.md
@@ -1192,7 +1192,133 @@ only if the Node.js binary was compiled with including support for the
 added: v11.0.0
 -->

-The WHATWG `TextDecoder` class. See the [`TextDecoder`][] section.
+An implementation of the [WHATWG Encoding Standard][] `TextDecoder` API.
+
+```js
+const decoder = new TextDecoder();
+const u8arr = new Uint8Array([72, 101, 108, 108, 111]);
+console.log(decoder.decode(u8arr)); // Hello
+```
+
+### WHATWG supported encodings
+
+Per the [WHATWG Encoding Standard][], the encodings supported by the
+`TextDecoder` API are outlined in the tables below. For each encoding,
+one or more aliases may be used.
+
+Different Node.js build configurations support different sets of encodings.
+(see [Internationalization][])
+
+#### Encodings supported by default (with full ICU data)
+
+| Encoding           | Aliases                                                                                                                                                                                                                             |
+| ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `'ibm866'`         | `'866'`, `'cp866'`, `'csibm866'`                                                                                                                                                                                                    |
+| `'iso-8859-2'`     | `'csisolatin2'`, `'iso-ir-101'`, `'iso8859-2'`, `'iso88592'`, `'iso_8859-2'`, `'iso_8859-2:1987'`, `'l2'`, `'latin2'`                                                                                                               |
+| `'iso-8859-3'`     | `'csisolatin3'`, `'iso-ir-109'`, `'iso8859-3'`, `'iso88593'`, `'iso_8859-3'`, `'iso_8859-3:1988'`, `'l3'`, `'latin3'`                                                                                                               |
+| `'iso-8859-4'`     | `'csisolatin4'`, `'iso-ir-110'`, `'iso8859-4'`, `'iso88594'`, `'iso_8859-4'`, `'iso_8859-4:1988'`, `'l4'`, `'latin4'`                                                                                                               |
+| `'iso-8859-5'`     | `'csisolatincyrillic'`, `'cyrillic'`, `'iso-ir-144'`, `'iso8859-5'`, `'iso88595'`, `'iso_8859-5'`, `'iso_8859-5:1988'`                                                                                                              |
+| `'iso-8859-6'`     | `'arabic'`, `'asmo-708'`, `'csiso88596e'`, `'csiso88596i'`, `'csisolatinarabic'`, `'ecma-114'`, `'iso-8859-6-e'`, `'iso-8859-6-i'`, `'iso-ir-127'`, `'iso8859-6'`, `'iso88596'`, `'iso_8859-6'`, `'iso_8859-6:1987'`                |
+| `'iso-8859-7'`     | `'csisolatingreek'`, `'ecma-118'`, `'elot_928'`, `'greek'`, `'greek8'`, `'iso-ir-126'`, `'iso8859-7'`, `'iso88597'`, `'iso_8859-7'`, `'iso_8859-7:1987'`, `'sun_eu_greek'`                                                          |
+| `'iso-8859-8'`     | `'csiso88598e'`, `'csisolatinhebrew'`, `'hebrew'`, `'iso-8859-8-e'`, `'iso-ir-138'`, `'iso8859-8'`, `'iso88598'`, `'iso_8859-8'`, `'iso_8859-8:1988'`, `'visual'`                                                                   |
+| `'iso-8859-8-i'`   | `'csiso88598i'`, `'logical'`                                                                                                                                                                                                        |
+| `'iso-8859-10'`    | `'csisolatin6'`, `'iso-ir-157'`, `'iso8859-10'`, `'iso885910'`, `'l6'`, `'latin6'`                                                                                                                                                  |
+| `'iso-8859-13'`    | `'iso8859-13'`, `'iso885913'`                                                                                                                                                                                                       |
+| `'iso-8859-14'`    | `'iso8859-14'`, `'iso885914'`                                                                                                                                                                                                       |
+| `'iso-8859-15'`    | `'csisolatin9'`, `'iso8859-15'`, `'iso885915'`, `'iso_8859-15'`, `'l9'`                                                                                                                                                             |
+| `'koi8-r'`         | `'cskoi8r'`, `'koi'`, `'koi8'`, `'koi8_r'`                                                                                                                                                                                          |
+| `'koi8-u'`         | `'koi8-ru'`                                                                                                                                                                                                                         |
+| `'macintosh'`      | `'csmacintosh'`, `'mac'`, `'x-mac-roman'`                                                                                                                                                                                           |
+| `'windows-874'`    | `'dos-874'`, `'iso-8859-11'`, `'iso8859-11'`, `'iso885911'`, `'tis-620'`                                                                                                                                                            |
+| `'windows-1250'`   | `'cp1250'`, `'x-cp1250'`                                                                                                                                                                                                            |
+| `'windows-1251'`   | `'cp1251'`, `'x-cp1251'`                                                                                                                                                                                                            |
+| `'windows-1252'`   | `'ansi_x3.4-1968'`, `'ascii'`, `'cp1252'`, `'cp819'`, `'csisolatin1'`, `'ibm819'`, `'iso-8859-1'`, `'iso-ir-100'`, `'iso8859-1'`, `'iso88591'`, `'iso_8859-1'`, `'iso_8859-1:1987'`, `'l1'`, `'latin1'`, `'us-ascii'`, `'x-cp1252'` |
+| `'windows-1253'`   | `'cp1253'`, `'x-cp1253'`                                                                                                                                                                                                            |
+| `'windows-1254'`   | `'cp1254'`, `'csisolatin5'`, `'iso-8859-9'`, `'iso-ir-148'`, `'iso8859-9'`, `'iso88599'`, `'iso_8859-9'`, `'iso_8859-9:1989'`, `'l5'`, `'latin5'`, `'x-cp1254'`                                                                     |
+| `'windows-1255'`   | `'cp1255'`, `'x-cp1255'`                                                                                                                                                                                                            |
+| `'windows-1256'`   | `'cp1256'`, `'x-cp1256'`                                                                                                                                                                                                            |
+| `'windows-1257'`   | `'cp1257'`, `'x-cp1257'`                                                                                                                                                                                                            |
+| `'windows-1258'`   | `'cp1258'`, `'x-cp1258'`                                                                                                                                                                                                            |
+| `'x-mac-cyrillic'` | `'x-mac-ukrainian'`                                                                                                                                                                                                                 |
+| `'gbk'`            | `'chinese'`, `'csgb2312'`, `'csiso58gb231280'`, `'gb2312'`, `'gb_2312'`, `'gb_2312-80'`, `'iso-ir-58'`, `'x-gbk'`                                                                                                                   |
+| `'gb18030'`        |                                                                                                                                                                                                                                     |
+| `'big5'`           | `'big5-hkscs'`, `'cn-big5'`, `'csbig5'`, `'x-x-big5'`                                                                                                                                                                               |
+| `'euc-jp'`         | `'cseucpkdfmtjapanese'`, `'x-euc-jp'`                                                                                                                                                                                               |
+| `'iso-2022-jp'`    | `'csiso2022jp'`                                                                                                                                                                                                                     |
+| `'shift_jis'`      | `'csshiftjis'`, `'ms932'`, `'ms_kanji'`, `'shift-jis'`, `'sjis'`, `'windows-31j'`, `'x-sjis'`                                                                                                                                       |
+| `'euc-kr'`         | `'cseuckr'`, `'csksc56011987'`, `'iso-ir-149'`, `'korean'`, `'ks_c_5601-1987'`, `'ks_c_5601-1989'`, `'ksc5601'`, `'ksc_5601'`, `'windows-949'`                                                                                      |
+
+#### Encodings supported when Node.js is built with the `small-icu` option
+
+| Encoding     | Aliases                         |
+| ------------ | ------------------------------- |
+| `'utf-8'`    | `'unicode-1-1-utf-8'`, `'utf8'` |
+| `'utf-16le'` | `'utf-16'`                      |
+| `'utf-16be'` |                                 |
+
+#### Encodings supported when ICU is disabled
+
+| Encoding     | Aliases                         |
+| ------------ | ------------------------------- |
+| `'utf-8'`    | `'unicode-1-1-utf-8'`, `'utf8'` |
+| `'utf-16le'` | `'utf-16'`                      |
+
+The `'iso-8859-16'` encoding listed in the [WHATWG Encoding Standard][]
+is not supported.
+
+### `new TextDecoder([encoding[, options]])`
+
+* `encoding` {string} Identifies the `encoding` that this `TextDecoder` instance
+  supports. **Default:** `'utf-8'`.
+* `options` {Object}
+  * `fatal` {boolean} `true` if decoding failures are fatal.
+    This option is not supported when ICU is disabled
+    (see [Internationalization][]). **Default:** `false`.
+  * `ignoreBOM` {boolean} When `true`, the `TextDecoder` will include the byte
+    order mark in the decoded result. When `false`, the byte order mark will
+    be removed from the output. This option is only used when `encoding` is
+    `'utf-8'`, `'utf-16be'`, or `'utf-16le'`. **Default:** `false`.
+
+Creates a new `TextDecoder` instance. The `encoding` may specify one of the
+supported encodings or an alias.
+
+The `TextDecoder` class is also available on the global object.
+
+### `textDecoder.decode([input[, options]])`
+
+* `input` {ArrayBuffer|DataView|TypedArray} An `ArrayBuffer`, `DataView`, or
+  `TypedArray` instance containing the encoded data.
+* `options` {Object}
+  * `stream` {boolean} `true` if additional chunks of data are expected.
+    **Default:** `false`.
+* Returns: {string}
+
+Decodes the `input` and returns a string. If `options.stream` is `true`, any
+incomplete byte sequences occurring at the end of the `input` are buffered
+internally and emitted after the next call to `textDecoder.decode()`.
+
+If `textDecoder.fatal` is `true`, decoding errors that occur will result in a
+`TypeError` being thrown.
+
+### `textDecoder.encoding`
+
+* Type: {string}
+
+The encoding supported by the `TextDecoder` instance.
+
+### `textDecoder.fatal`
+
+* Type: {boolean}
+
+The value will be `true` if decoding errors result in a `TypeError` being
+thrown.
+
+### `textDecoder.ignoreBOM`
+
+* Type: {boolean}
+
+The value will be `true` if the decoding result will include the byte order
+mark.

 ## Class: `TextDecoderStream`

@@ -1214,7 +1340,51 @@ A browser-compatible implementation of [`TextDecoderStream`][].
 added: v11.0.0
 -->

-The WHATWG `TextEncoder` class. See the [`TextEncoder`][] section.
+An implementation of the [WHATWG Encoding Standard][] `TextEncoder` API. All
+instances of `TextEncoder` only support UTF-8 encoding.
+
+```js
+const encoder = new TextEncoder();
+const uint8array = encoder.encode('this is some data');
+```
+
+The `TextEncoder` class is also available on the global object.
+
+### `textEncoder.encode([input])`
+
+* `input` {string} The text to encode. **Default:** an empty string.
+* Returns: {Uint8Array}
+
+UTF-8 encodes the `input` string and returns a `Uint8Array` containing the
+encoded bytes.
+
+### `textEncoder.encodeInto(src, dest)`
+
+<!-- YAML
+added: v12.11.0
+-->
+
+* `src` {string} The text to encode.
+* `dest` {Uint8Array} The array to hold the encode result.
+* Returns: {Object}
+  * `read` {number} The read Unicode code units of src.
+  * `written` {number} The written UTF-8 bytes of dest.
+
+UTF-8 encodes the `src` string to the `dest` Uint8Array and returns an object
+containing the read Unicode code units and written UTF-8 bytes.
+
+```js
+const encoder = new TextEncoder();
+const src = 'this is some data';
+const dest = new Uint8Array(10);
+const { read, written } = encoder.encodeInto(src, dest);
+```
+
+### `textEncoder.encoding`
+
+* Type: {string}
+
+The encoding supported by the `TextEncoder` instance. Always set to `'utf-8'`.

 ## Class: `TextEncoderStream`

@@ -1480,9 +1650,11 @@ A browser-compatible implementation of [`WritableStreamDefaultWriter`][].
 [CommonJS modules]: modules.md
 [ECMAScript module]: esm.md
 [HTML Standard]: https://html.spec.whatwg.org/multipage/workers.html
+[Internationalization]: intl.md
 [Navigator API]: https://html.spec.whatwg.org/multipage/system-state.html#the-navigator-object
 [RFC 5646]: https://www.rfc-editor.org/rfc/rfc5646.txt
 [Refable protocol]: process.md#processrefmayberefable
+[WHATWG Encoding Standard]: https://encoding.spec.whatwg.org/
 [Web Crypto API]: webcrypto.md
 [`--experimental-eventsource`]: cli.md#--experimental-eventsource
 [`--localstorage-file`]: cli.md#--localstorage-filefile
@@ -1514,9 +1686,7 @@ A browser-compatible implementation of [`WritableStreamDefaultWriter`][].
 [`Request`]: #class-request
 [`Response`]: #class-response
 [`TextDecoderStream`]: webstreams.md#class-textdecoderstream
-[`TextDecoder`]: util.md#class-utiltextdecoder
 [`TextEncoderStream`]: webstreams.md#class-textencoderstream
-[`TextEncoder`]: util.md#class-utiltextencoder
 [`TransformStreamDefaultController`]: webstreams.md#class-transformstreamdefaultcontroller
 [`TransformStream`]: webstreams.md#class-transformstream
 [`URLPattern`]: url.md#class-urlpattern
diff --git a/doc/api/util.md b/doc/api/util.md
index 176722568e4..c284f3c8b2d 100644
--- a/doc/api/util.md
+++ b/doc/api/util.md
@@ -2935,133 +2935,7 @@ changes:
     description: The class is now available on the global object.
 -->

-An implementation of the [WHATWG Encoding Standard][] `TextDecoder` API.
-
-```js
-const decoder = new TextDecoder();
-const u8arr = new Uint8Array([72, 101, 108, 108, 111]);
-console.log(decoder.decode(u8arr)); // Hello
-```
-
-### WHATWG supported encodings
-
-Per the [WHATWG Encoding Standard][], the encodings supported by the
-`TextDecoder` API are outlined in the tables below. For each encoding,
-one or more aliases may be used.
-
-Different Node.js build configurations support different sets of encodings.
-(see [Internationalization][])
-
-#### Encodings supported by default (with full ICU data)
-
-| Encoding           | Aliases                                                                                                                                                                                                                             |
-| ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `'ibm866'`         | `'866'`, `'cp866'`, `'csibm866'`                                                                                                                                                                                                    |
-| `'iso-8859-2'`     | `'csisolatin2'`, `'iso-ir-101'`, `'iso8859-2'`, `'iso88592'`, `'iso_8859-2'`, `'iso_8859-2:1987'`, `'l2'`, `'latin2'`                                                                                                               |
-| `'iso-8859-3'`     | `'csisolatin3'`, `'iso-ir-109'`, `'iso8859-3'`, `'iso88593'`, `'iso_8859-3'`, `'iso_8859-3:1988'`, `'l3'`, `'latin3'`                                                                                                               |
-| `'iso-8859-4'`     | `'csisolatin4'`, `'iso-ir-110'`, `'iso8859-4'`, `'iso88594'`, `'iso_8859-4'`, `'iso_8859-4:1988'`, `'l4'`, `'latin4'`                                                                                                               |
-| `'iso-8859-5'`     | `'csisolatincyrillic'`, `'cyrillic'`, `'iso-ir-144'`, `'iso8859-5'`, `'iso88595'`, `'iso_8859-5'`, `'iso_8859-5:1988'`                                                                                                              |
-| `'iso-8859-6'`     | `'arabic'`, `'asmo-708'`, `'csiso88596e'`, `'csiso88596i'`, `'csisolatinarabic'`, `'ecma-114'`, `'iso-8859-6-e'`, `'iso-8859-6-i'`, `'iso-ir-127'`, `'iso8859-6'`, `'iso88596'`, `'iso_8859-6'`, `'iso_8859-6:1987'`                |
-| `'iso-8859-7'`     | `'csisolatingreek'`, `'ecma-118'`, `'elot_928'`, `'greek'`, `'greek8'`, `'iso-ir-126'`, `'iso8859-7'`, `'iso88597'`, `'iso_8859-7'`, `'iso_8859-7:1987'`, `'sun_eu_greek'`                                                          |
-| `'iso-8859-8'`     | `'csiso88598e'`, `'csisolatinhebrew'`, `'hebrew'`, `'iso-8859-8-e'`, `'iso-ir-138'`, `'iso8859-8'`, `'iso88598'`, `'iso_8859-8'`, `'iso_8859-8:1988'`, `'visual'`                                                                   |
-| `'iso-8859-8-i'`   | `'csiso88598i'`, `'logical'`                                                                                                                                                                                                        |
-| `'iso-8859-10'`    | `'csisolatin6'`, `'iso-ir-157'`, `'iso8859-10'`, `'iso885910'`, `'l6'`, `'latin6'`                                                                                                                                                  |
-| `'iso-8859-13'`    | `'iso8859-13'`, `'iso885913'`                                                                                                                                                                                                       |
-| `'iso-8859-14'`    | `'iso8859-14'`, `'iso885914'`                                                                                                                                                                                                       |
-| `'iso-8859-15'`    | `'csisolatin9'`, `'iso8859-15'`, `'iso885915'`, `'iso_8859-15'`, `'l9'`                                                                                                                                                             |
-| `'koi8-r'`         | `'cskoi8r'`, `'koi'`, `'koi8'`, `'koi8_r'`                                                                                                                                                                                          |
-| `'koi8-u'`         | `'koi8-ru'`                                                                                                                                                                                                                         |
-| `'macintosh'`      | `'csmacintosh'`, `'mac'`, `'x-mac-roman'`                                                                                                                                                                                           |
-| `'windows-874'`    | `'dos-874'`, `'iso-8859-11'`, `'iso8859-11'`, `'iso885911'`, `'tis-620'`                                                                                                                                                            |
-| `'windows-1250'`   | `'cp1250'`, `'x-cp1250'`                                                                                                                                                                                                            |
-| `'windows-1251'`   | `'cp1251'`, `'x-cp1251'`                                                                                                                                                                                                            |
-| `'windows-1252'`   | `'ansi_x3.4-1968'`, `'ascii'`, `'cp1252'`, `'cp819'`, `'csisolatin1'`, `'ibm819'`, `'iso-8859-1'`, `'iso-ir-100'`, `'iso8859-1'`, `'iso88591'`, `'iso_8859-1'`, `'iso_8859-1:1987'`, `'l1'`, `'latin1'`, `'us-ascii'`, `'x-cp1252'` |
-| `'windows-1253'`   | `'cp1253'`, `'x-cp1253'`                                                                                                                                                                                                            |
-| `'windows-1254'`   | `'cp1254'`, `'csisolatin5'`, `'iso-8859-9'`, `'iso-ir-148'`, `'iso8859-9'`, `'iso88599'`, `'iso_8859-9'`, `'iso_8859-9:1989'`, `'l5'`, `'latin5'`, `'x-cp1254'`                                                                     |
-| `'windows-1255'`   | `'cp1255'`, `'x-cp1255'`                                                                                                                                                                                                            |
-| `'windows-1256'`   | `'cp1256'`, `'x-cp1256'`                                                                                                                                                                                                            |
-| `'windows-1257'`   | `'cp1257'`, `'x-cp1257'`                                                                                                                                                                                                            |
-| `'windows-1258'`   | `'cp1258'`, `'x-cp1258'`                                                                                                                                                                                                            |
-| `'x-mac-cyrillic'` | `'x-mac-ukrainian'`                                                                                                                                                                                                                 |
-| `'gbk'`            | `'chinese'`, `'csgb2312'`, `'csiso58gb231280'`, `'gb2312'`, `'gb_2312'`, `'gb_2312-80'`, `'iso-ir-58'`, `'x-gbk'`                                                                                                                   |
-| `'gb18030'`        |                                                                                                                                                                                                                                     |
-| `'big5'`           | `'big5-hkscs'`, `'cn-big5'`, `'csbig5'`, `'x-x-big5'`                                                                                                                                                                               |
-| `'euc-jp'`         | `'cseucpkdfmtjapanese'`, `'x-euc-jp'`                                                                                                                                                                                               |
-| `'iso-2022-jp'`    | `'csiso2022jp'`                                                                                                                                                                                                                     |
-| `'shift_jis'`      | `'csshiftjis'`, `'ms932'`, `'ms_kanji'`, `'shift-jis'`, `'sjis'`, `'windows-31j'`, `'x-sjis'`                                                                                                                                       |
-| `'euc-kr'`         | `'cseuckr'`, `'csksc56011987'`, `'iso-ir-149'`, `'korean'`, `'ks_c_5601-1987'`, `'ks_c_5601-1989'`, `'ksc5601'`, `'ksc_5601'`, `'windows-949'`                                                                                      |
-
-#### Encodings supported when Node.js is built with the `small-icu` option
-
-| Encoding     | Aliases                         |
-| ------------ | ------------------------------- |
-| `'utf-8'`    | `'unicode-1-1-utf-8'`, `'utf8'` |
-| `'utf-16le'` | `'utf-16'`                      |
-| `'utf-16be'` |                                 |
-
-#### Encodings supported when ICU is disabled
-
-| Encoding     | Aliases                         |
-| ------------ | ------------------------------- |
-| `'utf-8'`    | `'unicode-1-1-utf-8'`, `'utf8'` |
-| `'utf-16le'` | `'utf-16'`                      |
-
-The `'iso-8859-16'` encoding listed in the [WHATWG Encoding Standard][]
-is not supported.
-
-### `new TextDecoder([encoding[, options]])`
-
-* `encoding` {string} Identifies the `encoding` that this `TextDecoder` instance
-  supports. **Default:** `'utf-8'`.
-* `options` {Object}
-  * `fatal` {boolean} `true` if decoding failures are fatal.
-    This option is not supported when ICU is disabled
-    (see [Internationalization][]). **Default:** `false`.
-  * `ignoreBOM` {boolean} When `true`, the `TextDecoder` will include the byte
-    order mark in the decoded result. When `false`, the byte order mark will
-    be removed from the output. This option is only used when `encoding` is
-    `'utf-8'`, `'utf-16be'`, or `'utf-16le'`. **Default:** `false`.
-
-Creates a new `TextDecoder` instance. The `encoding` may specify one of the
-supported encodings or an alias.
-
-The `TextDecoder` class is also available on the global object.
-
-### `textDecoder.decode([input[, options]])`
-
-* `input` {ArrayBuffer|DataView|TypedArray} An `ArrayBuffer`, `DataView`, or
-  `TypedArray` instance containing the encoded data.
-* `options` {Object}
-  * `stream` {boolean} `true` if additional chunks of data are expected.
-    **Default:** `false`.
-* Returns: {string}
-
-Decodes the `input` and returns a string. If `options.stream` is `true`, any
-incomplete byte sequences occurring at the end of the `input` are buffered
-internally and emitted after the next call to `textDecoder.decode()`.
-
-If `textDecoder.fatal` is `true`, decoding errors that occur will result in a
-`TypeError` being thrown.
-
-### `textDecoder.encoding`
-
-* Type: {string}
-
-The encoding supported by the `TextDecoder` instance.
-
-### `textDecoder.fatal`
-
-* Type: {boolean}
-
-The value will be `true` if decoding errors result in a `TypeError` being
-thrown.
-
-### `textDecoder.ignoreBOM`
-
-* Type: {boolean}
-
-The value will be `true` if the decoding result will include the byte order
-mark.
+Deprecated alias for global [`TextDecoder`][].

 ## Class: `util.TextEncoder`

@@ -3074,51 +2948,7 @@ changes:
     description: The class is now available on the global object.
 -->

-An implementation of the [WHATWG Encoding Standard][] `TextEncoder` API. All
-instances of `TextEncoder` only support UTF-8 encoding.
-
-```js
-const encoder = new TextEncoder();
-const uint8array = encoder.encode('this is some data');
-```
-
-The `TextEncoder` class is also available on the global object.
-
-### `textEncoder.encode([input])`
-
-* `input` {string} The text to encode. **Default:** an empty string.
-* Returns: {Uint8Array}
-
-UTF-8 encodes the `input` string and returns a `Uint8Array` containing the
-encoded bytes.
-
-### `textEncoder.encodeInto(src, dest)`
-
-<!-- YAML
-added: v12.11.0
--->
-
-* `src` {string} The text to encode.
-* `dest` {Uint8Array} The array to hold the encode result.
-* Returns: {Object}
-  * `read` {number} The read Unicode code units of src.
-  * `written` {number} The written UTF-8 bytes of dest.
-
-UTF-8 encodes the `src` string to the `dest` Uint8Array and returns an object
-containing the read Unicode code units and written UTF-8 bytes.
-
-```js
-const encoder = new TextEncoder();
-const src = 'this is some data';
-const dest = new Uint8Array(10);
-const { read, written } = encoder.encodeInto(src, dest);
-```
-
-### `textEncoder.encoding`
-
-* Type: {string}
-
-The encoding supported by the `TextEncoder` instance. Always set to `'utf-8'`.
+Deprecated alias for global [`TextEncoder`][].

 ## `util.toUSVString(string)`

@@ -4163,9 +3993,7 @@ npx codemod@latest @nodejs/util-is
 [Custom inspection functions on objects]: #custom-inspection-functions-on-objects
 [Custom promisified functions]: #custom-promisified-functions
 [Customizing `util.inspect` colors]: #customizing-utilinspect-colors
-[Internationalization]: intl.md
 [Module Namespace Object]: https://tc39.github.io/ecma262/#sec-module-namespace-exotic-objects
-[WHATWG Encoding Standard]: https://encoding.spec.whatwg.org/
 [`'uncaughtException'`]: process.md#event-uncaughtexception
 [`'warning'`]: process.md#event-warning
 [`Array.isArray()`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/isArray
@@ -4176,6 +4004,8 @@ npx codemod@latest @nodejs/util-is
 [`Object.assign()`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/assign
 [`Object.freeze()`]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/freeze
 [`Runtime.ScriptId`]: https://chromedevtools.github.io/devtools-protocol/1-3/Runtime/#type-ScriptId
+[`TextDecoder`]: globals.md#class-textdecoder
+[`TextEncoder`]: globals.md#class-textencoder
 [`assert.deepStrictEqual()`]: assert.md#assertdeepstrictequalactual-expected-message
 [`assert.partialDeepStrictEqual()`]: assert.md#assertpartialdeepstrictequalactual-expected-message
 [`console.error()`]: console.md#consoleerrordata-args