Commit ec9d529
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: #22004
Reviewed-By: Gireesh Punathil <gpunathi@in.ibm.com>
Reviewed-By: Matteo Collina <matteo.collina@gmail.com>
Reviewed-By: Colin Ihrig <cjihrig@gmail.com>
Reviewed-By: Vladimir de Turckheim <vlad2t@hotmail.com>
Reviewed-By: Anna Henningsen <anna@addaleax.net>
Reviewed-By: Bryan English <bryan@bryanenglish.com>
Reviewed-By: Vse Mozhet Byt <vsemozhetbyt@gmail.com>
Reviewed-By: Gus Caplan <me@gus.host>
Reviewed-By: Сковорода Никита Андреевич <chalkerx@gmail.com>
Reviewed-By: Ruben Bridgewater <ruben@bridgewater.de>
Reviewed-By: Tobias Nießen <tniessen@tnie.de>
Reviewed-By: Michaël Zasso <targos@protonmail.com>
Reviewed-By: Michael Dawson <michael_dawson@ca.ibm.com>1 parent 7e23080 commit ec9d529
1 file changed
Lines changed: 11 additions & 0 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
@@ -929,6 +929,9 @@ Type: Documentation-only (supports [`--pending-deprecation`][]) | |||
| 929 | 929 | Using `process.binding()` in general should be avoided. The type checking | |
| 930 | 930 | methods in particular can be replaced by using [`util.types`][]. | |
| 931 | 931 | ||
| 932 | + This deprecation has been superseded by the deprecation of the | ||
| 933 | + `process.binding()` API ([DEP00XX](#DEP00XX)). | ||
| 934 | + | ||
| 932 | 935 | <a id="DEP0104"></a> | |
| 933 | 936 | ### DEP0104: process.env string coercion | |
| 934 | 937 | ||
@@ -987,6 +990,14 @@ Type: Documentation-only | |||
| 987 | 990 | The option `produceCachedData` has been deprecated. Use | |
| 988 | 991 | [`script.createCachedData()`][] instead. | |
| 989 | 992 | ||
| 993 | + <a id="DEP00XX"></a> | ||
| 994 | + ### DEP00XX: process.binding() | ||
| 995 | + | ||
| 996 | + Type: Documentation-only | ||
| 997 | + | ||
| 998 | + The `process.binding()` API is intended for use by Node.js internal code | ||
| 999 | + only. Use of `process.binding()` by userland code is unsupported. | ||
| 1000 | + | ||
| 990 | 1001 | [`--pending-deprecation`]: cli.html#cli_pending_deprecation | |
| 991 | 1002 | [`Buffer.allocUnsafeSlow(size)`]: buffer.html#buffer_class_method_buffer_allocunsafeslow_size | |
| 992 | 1003 | [`Buffer.from(array)`]: buffer.html#buffer_class_method_buffer_from_array | |
0 commit comments