suggestion for getSystemErrorMap() implementation

doc/api/util.md

@@ -369,9 +369,23 @@ Returns the string name for a numeric error code that comes from a Node.js API.
 The mapping between error codes and error names is platform-dependent.
 See [Common System Errors][] for the names of common errors.
 
+## `util.getSystemErrorMap()`
+<!-- YAML
+added: v9.7.0
+-->
+
+* Returns: {Map}
+
+Returns a Map of all system error codes available from 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 name = util.getSystemErrorName(err.errno);
+  const errorMap = util.getSystemErrorMap();
+  const name = errorMap.get(err.errno);
   console.error(name);  // ENOENT
 });
 ```

lib/internal/util.js

@@ -53,6 +53,14 @@ const experimentalWarnings = new SafeSet();
 
 const colorRegExp = /\u001b\[\d\d?m/g; // eslint-disable-line no-control-regex
 
+
+let uvBinding;
+
+function lazyUv() {
+  uvBinding ??= internalBinding('uv');
+  return uvBinding;
+}
+
 function removeColors(str) {
   return StringPrototypeReplace(str, colorRegExp, '');
 }
@@ -286,6 +294,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');
 
@@ -443,6 +455,7 @@ module.exports = {
   filterDuplicateStrings,
   getConstructorOf,
   getSystemErrorName,
+  getSystemErrorMap,
   isError,
   isInsideNodeModules,
   join,

lib/util.js

@@ -68,6 +68,7 @@ const types = require('internal/util/types');
 const {
   deprecate,
   getSystemErrorName: internalErrorName,
+  getSystemErrorMap,
   promisify
 } = require('internal/util');
 
@@ -257,6 +258,7 @@ module.exports = {
   format,
   formatWithOptions,
   getSystemErrorName,
+  getSystemErrorMap,
   inherits,
   inspect,
   isArray: ArrayIsArray,

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);
+});