util: add getSystemErrorMap() impl

PR-URL: #38101Fixes: #37951 Reviewed-By: Antoine du Hamel <[email protected]> Reviewed-By: Darshan Sen <[email protected]> Reviewed-By: Benjamin Gruenbaum <[email protected]> Reviewed-By: Juan José Arboleda <[email protected]> Reviewed-By: James M Snell <[email protected]>

Author: eladkishon

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) =>{
+consterrorMap=util.getSystemErrorMap();
+constname=errorMap.get(err.errno);
+console.error(name); // ENOENT
+});
+```
+
 ## `util.inherits(constructor, superConstructor)`
 <!-- YAML
 added: v0.3.0

lib/internal/util.js

@@ -44,6 +44,13 @@ const experimentalWarnings = new Set();
 
 constcolorRegExp=/\u001b\[\d\d?m/g;// eslint-disable-line no-control-regex
 
+letuvBinding;
+
+functionlazyUv(){
+uvBinding=uvBinding??internalBinding('uv');
+returnuvBinding;
+}
+
 functionremoveColors(str){
 returnstr.replace(colorRegExp,'');
 }
@@ -271,6 +278,10 @@ function getSystemErrorName(err){
 returnentry ? entry[0] : `Unknown system error ${err}`;
 }
 
+functiongetSystemErrorMap(){
+returnlazyUv().getErrorMap();
+}
+
 constkCustomPromisifiedSymbol=SymbolFor('nodejs.util.promisify.custom');
 constkCustomPromisifyArgsSymbol=Symbol('customPromisifyArgs');
 
@@ -414,6 +425,7 @@ module.exports ={
  emitExperimentalWarning,
  filterDuplicateStrings,
  getConstructorOf,
+ getSystemErrorMap,
  getSystemErrorName,
  isError,
  isInsideNodeModules,

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,

test/parallel/test-uv-errmap.js

@@ -0,0 +1,24 @@
+// Flags: --expose-internals
+'use strict';
+
+require('../common');
+constassert=require('assert');
+const{
+ getSystemErrorMap,
+ _errnoException
+}=require('util');
+
+const{ internalBinding }=require('internal/test/binding');
+constuv=internalBinding('uv');
+constuvKeys=Object.keys(uv);
+
+consterrMap=getSystemErrorMap();
+
+uvKeys.forEach((key)=>{
+if(!key.startsWith('UV_'))
+return;
+
+consterr=_errnoException(uv[key]);
+constname=uv.errname(uv[key]);
+assert.strictEqual(errMap.get(err.errno)[0],name);
+});