From baed2763df83bbdebba6a5064d0a2ed4632eefbc Mon Sep 17 00:00:00 2001
From: Carlos Espa <43477095+Ceres6@users.noreply.github.com>
Date: Mon, 25 Nov 2024 23:48:24 +0100
Subject: [PATCH] doc: deprecate passing invalid types in `fs.existsSync`

PR-URL: https://github.com/nodejs/node/pull/55892
Reviewed-By: James M Snell <jasnell@gmail.com>
Reviewed-By: Luigi Pinca <luigipinca@gmail.com>
Reviewed-By: Jason Zhang <xzha4350@gmail.com>
---
 doc/api/deprecations.md | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/doc/api/deprecations.md b/doc/api/deprecations.md
index 3038914b6e3ff2..2b3cd9f86aee06 100644
--- a/doc/api/deprecations.md
+++ b/doc/api/deprecations.md
@@ -3756,6 +3756,20 @@ It is recommended to use the `new` qualifier instead. This applies to all REPL c
 
 <!-- md-lint skip-deprecation DEP0186 -->
 
+### DEP0187: Passing invalid argument types to `fs.existsSync`
+
+<!-- YAML
+changes:
+  - version: REPLACEME
+    pr-url: https://github.com/nodejs/node/pull/55892
+    description: Documentation-only.
+-->
+
+Type: Documentation-only
+
+Passing non-supported argument types is deprecated and, instead of returning `false`,
+will throw an error in a future version.
+
 [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