From 84feb3b29389aa11707226b84c3bbb0e87a6f84a Mon Sep 17 00:00:00 2001
From: Luigi Pinca <luigipinca@gmail.com>
Date: Thu, 6 May 2021 15:45:04 +0200
Subject: [PATCH] os: add os.devNull
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Provides the platform-specific file path of the null device.

PR-URL: https://github.com/nodejs/node/pull/38569
Reviewed-By: James M Snell <jasnell@gmail.com>
Reviewed-By: Colin Ihrig <cjihrig@gmail.com>
Reviewed-By: Rich Trott <rtrott@gmail.com>
Reviewed-By: Darshan Sen <raisinten@gmail.com>
Reviewed-By: Tobias Nießen <tniessen@tnie.de>
---
 doc/api/os.md            | 12 ++++++++++++
 lib/os.js                |  7 +++++++
 test/parallel/test-os.js |  7 +++++++
 3 files changed, 26 insertions(+)

diff --git a/doc/api/os.md b/doc/api/os.md
index 79622b33d3e860..ab39a81904149f 100644
--- a/doc/api/os.md
+++ b/doc/api/os.md
@@ -122,6 +122,18 @@ The properties included on each object include:
 `nice` values are POSIX-only. On Windows, the `nice` values of all processors
 are always 0.
 
+## `os.devNull`
+<!-- YAML
+added: REPLACEME
+-->
+
+* {string}
+
+The platform-specific file path of the null device.
+
+* `\\.\nul` on Windows
+* `/dev/null` on POSIX
+
 ## `os.endianness()`
 <!-- YAML
 added: v0.9.4
diff --git a/lib/os.js b/lib/os.js
index 64b25eeb4124d1..fe25653a4618eb 100644
--- a/lib/os.js
+++ b/lib/os.js
@@ -382,5 +382,12 @@ ObjectDefineProperties(module.exports, {
     enumerable: true,
     writable: false,
     value: isWindows ? '\r\n' : '\n'
+  },
+
+  devNull: {
+    configurable: true,
+    enumerable: true,
+    writable: false,
+    value: isWindows ? '\\\\.\\nul' : '/dev/null'
   }
 });
diff --git a/test/parallel/test-os.js b/test/parallel/test-os.js
index 922bab276bcb3c..da61a0a235ee0f 100644
--- a/test/parallel/test-os.js
+++ b/test/parallel/test-os.js
@@ -257,3 +257,10 @@ if (!common.isIBMi) {
 
 is.number(+os.freemem, 'freemem');
 is.number(os.freemem(), 'freemem');
+
+const devNull = os.devNull;
+if (common.isWindows) {
+  assert.strictEqual(devNull, '\\\\.\\nul');
+} else {
+  assert.strictEqual(devNull, '/dev/null');
+}