Commit 50df052
doc: note that path.normalize deviates from POSIX
PR-URL: #51513
Refs: #51345
Reviewed-By: Yagiz Nizipli <yagiz.nizipli@sentry.io>
Reviewed-By: Antoine du Hamel <duhamelantoine1995@gmail.com>
Reviewed-By: Luigi Pinca <luigipinca@gmail.com>1 parent 133719b commit 50df052
1 file changed
Lines changed: 8 additions & 0 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
@@ -361,6 +361,14 @@ instance of the platform-specific path segment separator (`/` on POSIX and | |||
| 361 | 361 | If the `path` is a zero-length string, `'.'` is returned, representing the | |
| 362 | 362 | current working directory. | |
| 363 | 363 | ||
| 364 | + On POSIX, the types of normalization applied by this function do not strictly | ||
| 365 | + adhere to the POSIX specification. For example, this function will replace two | ||
| 366 | + leading forward slashes with a single slash as if it was a regular absolute | ||
| 367 | + path, whereas a few POSIX systems assign special meaning to paths beginning with | ||
| 368 | + exactly two forward slashes. Similarly, other substitutions performed by this | ||
| 369 | + function, such as removing `..` segments, may change how the underlying system | ||
| 370 | + resolves the path. | ||
| 371 | + | ||
| 364 | 372 | For example, on POSIX: | |
| 365 | 373 | ||
| 366 | 374 | ```js | |
0 commit comments