process: deprecate features.{ipv6,uv} and features.tls_*

Renegade334 · ruyadorno · commit ea4891856d30 · 2025-01-05T12:57:28.000-05:00
PR-URL: #55545 Fixes: #55537 Reviewed-By: Marco Ippolito <marcoippolito54@gmail.com> Reviewed-By: James M Snell <jasnell@gmail.com> Reviewed-By: Juan José Arboleda <soyjuanarbol@gmail.com>
diff --git a/doc/api/deprecations.md b/doc/api/deprecations.md
@@ -3701,6 +3701,33 @@ Type: Documentation-only
 Passing non-supported argument types is deprecated and, instead of returning `false`,
 will throw an error in a future version.
 
+### DEP0187: `process.features.ipv6` and `process.features.uv`
+
+<!-- YAML
+changes:
+  - version: REPLACEME
+    pr-url: https://github.com/nodejs/node/pull/55545
+    description: Documentation-only deprecation.
+-->
+
+Type: Documentation-only
+
+These properties are unconditionally `true`. Any checks based on these properties are redundant.
+
+### DEP0188: `process.features.tls_*`
+
+<!-- YAML
+changes:
+  - version: REPLACEME
+    pr-url: https://github.com/nodejs/node/pull/55545
+    description: Documentation-only deprecation.
+-->
+
+Type: Documentation-only
+
+`process.features.tls_alpn`, `process.features.tls_ocsp`, and `process.features.tls_sni` are
+deprecated, as their values are guaranteed to be identical to that of `process.features.tls`.
+
 [NIST SP 800-38D]: https://nvlpubs.nist.gov/nistpubs/Legacy/SP/nistspecialpublication800-38d.pdf
 [RFC 6066]: https://tools.ietf.org/html/rfc6066#section-3
 [RFC 8247 Section 2.4]: https://www.rfc-editor.org/rfc/rfc8247#section-2.4
diff --git a/doc/api/process.md b/doc/api/process.md
@@ -1922,12 +1922,18 @@ A boolean value that is `true` if the current Node.js build includes the inspect
 
 <!-- YAML
 added: v0.5.3
+deprecated: REPLACEME
 -->
 
+> Stability: 0 - Deprecated. This property is always true, and any checks based on it are
+> redundant.
+
 * {boolean}
 
 A boolean value that is `true` if the current Node.js build includes support for IPv6.
 
+Since all Node.js builds have IPv6 support, this value is always `true`.
+
 ## `process.features.require_module`
 
 <!-- YAML
@@ -1953,32 +1959,50 @@ A boolean value that is `true` if the current Node.js build includes support for
 
 <!-- YAML
 added: v4.8.0
+deprecated: REPLACEME
 -->
 
+> Stability: 0 - Deprecated. Use `process.features.tls` instead.
+
 * {boolean}
 
 A boolean value that is `true` if the current Node.js build includes support for ALPN in TLS.
 
+In Node.js 11.0.0 and later versions, the OpenSSL dependencies feature unconditional ALPN support.
+This value is therefore identical to that of `process.features.tls`.
+
 ## `process.features.tls_ocsp`
 
 <!-- YAML
 added: v0.11.13
+deprecated: REPLACEME
 -->
 
+> Stability: 0 - Deprecated. Use `process.features.tls` instead.
+
 * {boolean}
 
 A boolean value that is `true` if the current Node.js build includes support for OCSP in TLS.
 
+In Node.js 11.0.0 and later versions, the OpenSSL dependencies feature unconditional OCSP support.
+This value is therefore identical to that of `process.features.tls`.
+
 ## `process.features.tls_sni`
 
 <!-- YAML
 added: v0.5.3
+deprecated: REPLACEME
 -->
 
+> Stability: 0 - Deprecated. Use `process.features.tls` instead.
+
 * {boolean}
 
 A boolean value that is `true` if the current Node.js build includes support for SNI in TLS.
 
+In Node.js 11.0.0 and later versions, the OpenSSL dependencies feature unconditional SNI support.
+This value is therefore identical to that of `process.features.tls`.
+
 ## `process.features.typescript`
 
 <!-- YAML
@@ -1996,12 +2020,17 @@ A value that is `"strip"` if Node.js is run with `--experimental-strip-types`,
 
 <!-- YAML
 added: v0.5.3
+deprecated: REPLACEME
 -->
 
+> Stability: 0 - Deprecated. This property is always true, and any checks based on it are
+> redundant.
+
 * {boolean}
 
 A boolean value that is `true` if the current Node.js build includes support for libuv.
-Since it's currently not possible to build Node.js without libuv, this value is always `true`.
+
+Since it's not possible to build Node.js without libuv, this value is always `true`.
 
 ## `process.finalization.register(ref, callback)`
 
