doc: deprecate passing invalid types in fs.existsSync

PR-URL: nodejs#55892 Reviewed-By: James M Snell <[email protected]> Reviewed-By: Luigi Pinca <[email protected]> Reviewed-By: Jason Zhang <[email protected]>
Ceres6 · Nov 26, 2024 · 8caeeef · 8caeeef
1 parent f3e3cab
commit 8caeeef
Showing 1 changed file with 3 additions and 2 deletions.
diff --git a/doc/api/deprecations.md b/doc/api/deprecations.md
@@ -3772,7 +3772,7 @@ It is recommended to use the `new` qualifier instead. This applies to all REPL c
 
 <!-- md-lint skip-deprecation DEP0186 -->
 
-### DEP0187: `fs.existsSync` never throw on invalid arguments
+### DEP0187: Passing invalid argument types to `fs.existsSync`
 
 <!-- YAML
 changes:
@@ -3783,7 +3783,8 @@ changes:
 
 Type: Runtime
 
-Passing invalid argument types is deprecated.
+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