util: runtime deprecate util.log

fix pr url PR-URL: #50488 Reviewed-By: Rafael Gonzaga <[email protected]> Reviewed-By: Yagiz Nizipli <[email protected]> Reviewed-By: Robert Nagy <[email protected]> Reviewed-By: James M Snell <[email protected]> Reviewed-By: Ruben Bridgewater <[email protected]> Reviewed-By: Joyee Cheung <[email protected]>
nodejs · Nov 27, 2023 · e96cd25 · e96cd25
1 parent 6cf20d5
commit e96cd25
Show file tree

Hide file tree

Showing 2 changed files with 8 additions and 2 deletions.
diff --git a/doc/api/deprecations.md b/doc/api/deprecations.md
@@ -1313,6 +1313,9 @@ The [`util.isUndefined()`][] API is deprecated.
 
 <!-- YAML
 changes:
+  - version: REPLACEME
+    pr-url: https://github.com/nodejs/node/pull/50488
+    description: Runtime deprecation.
   - version: v6.12.0
     pr-url: https://github.com/nodejs/node/pull/10116
     description: A deprecation code has been assigned.
@@ -1321,7 +1324,7 @@ changes:
     description: Documentation-only deprecation.
 -->
 
-Type: Documentation-only
+Type: Runtime
 
 The [`util.log()`][] API is deprecated.
 

diff --git a/lib/util.js b/lib/util.js
@@ -446,7 +446,10 @@ module.exports = {
                          'Please use `arg === null || ' +
                          '(typeof arg !== "object" && typeof arg !== "function")` instead.',
                          'DEP0054'),
-  log: deprecate(log, 'The `util.log API is deprecated.', 'DEP0059'),
+  log: deprecate(log,
+                 'The `util.log API is deprecated. ' +
+                 'Please use console.log() with a custom formatter or a third-party logger instead.',
+                 'DEP0059'),
   promisify,
   stripVTControlCharacters,
   toUSVString,