path: add path.devnull

`path.devnull` provides the platform-specific file path of the null device.
nodejs · May 6, 2021 · ad1961d · ad1961d
1 parent aed17e9
commit ad1961d
Show file tree

Hide file tree

Showing 3 changed files with 20 additions and 0 deletions.
diff --git a/doc/api/path.md b/doc/api/path.md
@@ -135,6 +135,18 @@ process.env.PATH.split(path.delimiter);
 // Returns ['C:\\Windows\\system32', 'C:\\Windows', 'C:\\Program Files\\node\\']
 ```
 
+## `path.devnull`
+<!-- YAML
+added: REPLACEME
+-->
+
+* {string}
+
+Provides the platform-specific file path of the null device:
+
+* `\\.\nul` on Windows
+* `/dev/null` on POSIX
+
 ## `path.dirname(path)`
 <!-- YAML
 added: v0.1.16

diff --git a/lib/path.js b/lib/path.js
@@ -1065,6 +1065,7 @@ const win32 = {
     return ret;
   },
 
+  devnull: '\\\\.\\nul',
   sep: '\\',
   delimiter: ';',
   win32: null,
@@ -1531,6 +1532,7 @@ const posix = {
     return ret;
   },
 
+  devnull: '/dev/null',
   sep: '/',
   delimiter: ':',
   win32: null,

diff --git a/test/parallel/test-path.js b/test/parallel/test-path.js
@@ -67,6 +67,12 @@ assert.strictEqual(path.win32.delimiter, ';');
 // posix
 assert.strictEqual(path.posix.delimiter, ':');
 
+// path.devnull tests
+// windows
+assert.strictEqual(path.win32.devnull, '\\\\.\\nul');
+// posix
+assert.strictEqual(path.posix.devnull, '/dev/null');
+
 if (common.isWindows)
   assert.strictEqual(path, path.win32);
 else