From 08a6d9effd4e27aa45a04a0624995e618f5f8628 Mon Sep 17 00:00:00 2001
From: eladkeyshawn <elad.keyshawn@gmail.com>
Date: Tue, 6 Apr 2021 00:18:34 +0300
Subject: [PATCH] util: add getSystemErrorMap() impl
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

PR-URL: https://github.com/nodejs/node/pull/38101
Fixes: https://github.com/nodejs/node/issues/37951
Reviewed-By: Antoine du Hamel <duhamelantoine1995@gmail.com>
Reviewed-By: Darshan Sen <raisinten@gmail.com>
Reviewed-By: Benjamin Gruenbaum <benjamingr@gmail.com>
Reviewed-By: Juan José Arboleda <soyjuanarbol@gmail.com>
Reviewed-By: James M Snell <jasnell@gmail.com>
---
 doc/api/util.md                 | 19 +++++++++++++++++++
 lib/internal/util.js            | 12 ++++++++++++
 lib/util.js                     |  2 ++
 test/parallel/test-uv-errmap.js | 24 ++++++++++++++++++++++++
 4 files changed, 57 insertions(+)
 create mode 100644 test/parallel/test-uv-errmap.js

diff --git a/doc/api/util.md b/doc/api/util.md
index ab634380c3c406..e52c54176da014 100644
--- a/doc/api/util.md
+++ b/doc/api/util.md
@@ -376,6 +376,25 @@ fs.access('file/that/does/not/exist', (err) => {
 });
 ```
 
+## `util.getSystemErrorMap()`
+<!-- YAML
+added: REPLACEME
+-->
+
+* Returns: {Map}
+
+Returns a Map of all system error codes available from the Node.js API.
+The mapping between error codes and error names is platform-dependent.
+See [Common System Errors][] for the names of common errors.
+
+```js
+fs.access('file/that/does/not/exist', (err) => {
+  const errorMap = util.getSystemErrorMap();
+  const name = errorMap.get(err.errno);
+  console.error(name);  // ENOENT
+});
+```
+
 ## `util.inherits(constructor, superConstructor)`
 <!-- YAML
 added: v0.3.0
diff --git a/lib/internal/util.js b/lib/internal/util.js
index f26ea970e8dce0..68aade2d03d991 100644
--- a/lib/internal/util.js
+++ b/lib/internal/util.js
@@ -44,6 +44,13 @@ const experimentalWarnings = new Set();
 
 const colorRegExp = /\u001b\[\d\d?m/g; // eslint-disable-line no-control-regex
 
+let uvBinding;
+
+function lazyUv() {
+  uvBinding = uvBinding ?? internalBinding('uv');
+  return uvBinding;
+}
+
 function removeColors(str) {
   return str.replace(colorRegExp, '');
 }
@@ -271,6 +278,10 @@ function getSystemErrorName(err) {
   return entry ? entry[0] : `Unknown system error ${err}`;
 }
 
+function getSystemErrorMap() {
+  return lazyUv().getErrorMap();
+}
+
 const kCustomPromisifiedSymbol = SymbolFor('nodejs.util.promisify.custom');
 const kCustomPromisifyArgsSymbol = Symbol('customPromisifyArgs');
 
@@ -414,6 +425,7 @@ module.exports = {
   emitExperimentalWarning,
   filterDuplicateStrings,
   getConstructorOf,
+  getSystemErrorMap,
   getSystemErrorName,
   isError,
   isInsideNodeModules,
diff --git a/lib/util.js b/lib/util.js
index 1414c0d11d58a8..63a20d581cdd5a 100644
--- a/lib/util.js
+++ b/lib/util.js
@@ -57,6 +57,7 @@ const types = require('internal/util/types');
 
 const {
   deprecate,
+  getSystemErrorMap,
   getSystemErrorName: internalErrorName,
   promisify
 } = require('internal/util');
@@ -244,6 +245,7 @@ module.exports = {
   deprecate,
   format,
   formatWithOptions,
+  getSystemErrorMap,
   getSystemErrorName,
   inherits,
   inspect,
diff --git a/test/parallel/test-uv-errmap.js b/test/parallel/test-uv-errmap.js
new file mode 100644
index 00000000000000..6a077551b63d77
--- /dev/null
+++ b/test/parallel/test-uv-errmap.js
@@ -0,0 +1,24 @@
+// Flags: --expose-internals
+'use strict';
+
+require('../common');
+const assert = require('assert');
+const {
+  getSystemErrorMap,
+  _errnoException
+} = require('util');
+
+const { internalBinding } = require('internal/test/binding');
+const uv = internalBinding('uv');
+const uvKeys = Object.keys(uv);
+
+const errMap = getSystemErrorMap();
+
+uvKeys.forEach((key) => {
+  if (!key.startsWith('UV_'))
+    return;
+
+  const err = _errnoException(uv[key]);
+  const name = uv.errname(uv[key]);
+  assert.strictEqual(errMap.get(err.errno)[0], name);
+});