Skip to content

Commit 182051b

Browse files
committed
doc: documentation deprecation of process.binding
This is the first step in a long process of deprecating `process.binding()` and replacing it with `internalBinding()`. Eventually, once we have replaced internal uses of `process.binding()` with `internalBinding()`, we can escalate to a runtime deprecation and eventual end-of-life. PR-URL: nodejs#22004 Reviewed-By: Gireesh Punathil <[email protected]> Reviewed-By: Matteo Collina <[email protected]> Reviewed-By: Colin Ihrig <[email protected]> Reviewed-By: Vladimir de Turckheim <[email protected]> Reviewed-By: Anna Henningsen <[email protected]> Reviewed-By: Bryan English <[email protected]> Reviewed-By: Vse Mozhet Byt <[email protected]> Reviewed-By: Gus Caplan <[email protected]> Reviewed-By: Сковорода Никита Андреевич <[email protected]> Reviewed-By: Ruben Bridgewater <[email protected]> Reviewed-By: Tobias Nießen <[email protected]> Reviewed-By: Michaël Zasso <[email protected]> Reviewed-By: Michael Dawson <[email protected]>
1 parent 8a62cdb commit 182051b

File tree

1 file changed

+11
-0
lines changed

1 file changed

+11
-0
lines changed

doc/api/deprecations.md

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -929,6 +929,9 @@ Type: Documentation-only (supports [`--pending-deprecation`][])
929929
Using `process.binding()` in general should be avoided. The type checking
930930
methods in particular can be replaced by using [`util.types`][].
931931
932+
This deprecation has been superseded by the deprecation of the
933+
`process.binding()` API ([DEP00XX](#DEP00XX)).
934+
932935
<a id="DEP0104"></a>
933936
### DEP0104: process.env string coercion
934937
@@ -999,6 +1002,14 @@ Type: Documentation-only
9991002
The option `produceCachedData` has been deprecated. Use
10001003
[`script.createCachedData()`][] instead.
10011004
1005+
<a id="DEP00XX"></a>
1006+
### DEP00XX: process.binding()
1007+
1008+
Type: Documentation-only
1009+
1010+
The `process.binding()` API is intended for use by Node.js internal code
1011+
only. Use of `process.binding()` by userland code is unsupported.
1012+
10021013
[`--pending-deprecation`]: cli.html#cli_pending_deprecation
10031014
[`Buffer.allocUnsafeSlow(size)`]: buffer.html#buffer_class_method_buffer_allocunsafeslow_size
10041015
[`Buffer.from(array)`]: buffer.html#buffer_class_method_buffer_from_array

0 commit comments

Comments
 (0)