From a59c7aeb2717cefff6d8e54e9dca72491cfaa2d0 Mon Sep 17 00:00:00 2001
From: marco-ippolito <marcoippolito54@gmail.com>
Date: Mon, 29 Apr 2024 10:47:03 +0200
Subject: [PATCH] util: move util.isUndefined to eol
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

PR-URL: https://github.com/nodejs/node/pull/52744
Reviewed-By: Benjamin Gruenbaum <benjamingr@gmail.com>
Reviewed-By: Yagiz Nizipli <yagiz.nizipli@sentry.io>
Reviewed-By: Matteo Collina <matteo.collina@gmail.com>
Reviewed-By: Rafael Gonzaga <rafael.nunu@hotmail.com>
Reviewed-By: Ulises Gascón <ulisesgascongonzalez@gmail.com>
Reviewed-By: Paolo Insogna <paolo@cowtech.it>
Reviewed-By: Trivikram Kamat <trivikr.dev@gmail.com>
Reviewed-By: Moshe Atlow <moshe@atlow.co.il>
Reviewed-By: James M Snell <jasnell@gmail.com>
---
 doc/api/deprecations.md    |  8 +++++---
 doc/api/util.md            | 26 --------------------------
 lib/util.js                | 12 ------------
 test/parallel/test-util.js |  5 -----
 4 files changed, 5 insertions(+), 46 deletions(-)

diff --git a/doc/api/deprecations.md b/doc/api/deprecations.md
index 8becf526a2..bc12ed65b7 100644
--- a/doc/api/deprecations.md
+++ b/doc/api/deprecations.md
@@ -1331,6 +1331,9 @@ The `util.isSymbol()` API has been removed. Please use
 
 <!-- YAML
 changes:
+  - version: REPLACEME
+    pr-url: https://github.com/nodejs/node/pull/52744
+    description: End-of-Life deprecation.
   - version: v22.0.0
     pr-url: https://github.com/nodejs/node/pull/50488
     description: Runtime deprecation.
@@ -1346,9 +1349,9 @@ changes:
     description: Documentation-only deprecation.
 -->
 
-Type: Runtime
+Type: End-of-Life
 
-The [`util.isUndefined()`][] API is deprecated. Please use
+The `util.isUndefined()` API has been removed. Please use
 `arg === undefined` instead.
 
 ### DEP0059: `util.log()`
@@ -3802,7 +3805,6 @@ is deprecated to better align with recommendations per [NIST SP 800-38D][].
 [`util.isObject()`]: util.md#utilisobjectobject
 [`util.isPrimitive()`]: util.md#utilisprimitiveobject
 [`util.isRegExp()`]: util.md#utilisregexpobject
-[`util.isUndefined()`]: util.md#utilisundefinedobject
 [`util.log()`]: util.md#utillogstring
 [`util.promisify`]: util.md#utilpromisifyoriginal
 [`util.toUSVString()`]: util.md#utiltousvstringstring
diff --git a/doc/api/util.md b/doc/api/util.md
index b5c8f7d2ca..1b2156ee92 100644
--- a/doc/api/util.md
+++ b/doc/api/util.md
@@ -3140,32 +3140,6 @@ util.isRegExp({});
 // Returns: false
 ```
 
-### `util.isUndefined(object)`
-
-<!-- YAML
-added: v0.11.5
-deprecated: v4.0.0
--->
-
-> Stability: 0 - Deprecated: Use `value === undefined` instead.
-
-* `object` {any}
-* Returns: {boolean}
-
-Returns `true` if the given `object` is `undefined`. Otherwise, returns `false`.
-
-```js
-const util = require('node:util');
-
-const foo = undefined;
-util.isUndefined(5);
-// Returns: false
-util.isUndefined(foo);
-// Returns: true
-util.isUndefined(null);
-// Returns: false
-```
-
 ### `util.log(string)`
 
 <!-- YAML
diff --git a/lib/util.js b/lib/util.js
index bc6c92804a..e3bdf67eea 100644
--- a/lib/util.js
+++ b/lib/util.js
@@ -90,15 +90,6 @@ function lazyAbortController() {
 
 let internalDeepEqual;
 
-/**
- * @deprecated since v4.0.0
- * @param {any} arg
- * @returns {arg is undefined}
- */
-function isUndefined(arg) {
-  return arg === undefined;
-}
-
 /**
  * @deprecated since v4.0.0
  * @param {any} arg
@@ -372,9 +363,6 @@ module.exports = {
     }
     return internalDeepEqual(a, b);
   },
-  isUndefined: deprecate(isUndefined,
-                         'The `util.isUndefined` API is deprecated. Please use `arg === undefined` instead.',
-                         'DEP0058'),
   isRegExp: deprecate(types.isRegExp,
                       'The `util.isRegExp` API is deprecated. Please use `arg instanceof RegExp` instead.',
                       'DEP0055'),
diff --git a/test/parallel/test-util.js b/test/parallel/test-util.js
index 52db5aaa13..357a8f64c6 100644
--- a/test/parallel/test-util.js
+++ b/test/parallel/test-util.js
@@ -98,11 +98,6 @@ assert.strictEqual(util.isPrimitive(Infinity), true);
 assert.strictEqual(util.isPrimitive(NaN), true);
 assert.strictEqual(util.isPrimitive(Symbol('symbol')), true);
 
-assert.strictEqual(util.isUndefined(undefined), true);
-assert.strictEqual(util.isUndefined(), true);
-assert.strictEqual(util.isUndefined(null), false);
-assert.strictEqual(util.isUndefined('string'), false);
-
 assert.strictEqual(util.isFunction(() => {}), true);
 assert.strictEqual(util.isFunction(function() {}), true);
 assert.strictEqual(util.isFunction(), false);