lib: add cause to DOMException

PR-URL: #44703
Reviewed-By: Antoine du Hamel <[email protected]>
Reviewed-By: Chengzhong Wu <[email protected]>

Author: flakey5

lib/internal/per_context/domexception.js

@@ -49,12 +49,31 @@ const disusedNamesSet = new SafeSet()
   .add('ValidationError');
 
 class DOMException {
-  constructor(message = '', name = 'Error') {
+  constructor(message = '', options = 'Error') {
     ErrorCaptureStackTrace(this);
-    internalsMap.set(this, {
-      message: `${message}`,
-      name: `${name}`
-    });
+
+    if (options && typeof options === 'object') {
+      const { name } = options;
+      internalsMap.set(this, {
+        message: `${message}`,
+        name: `${name}`
+      });
+
+      if ('cause' in options) {
+        ObjectDefineProperty(this, 'cause', {
+          __proto__: null,
+          value: options.cause,
+          configurable: true,
+          writable: true,
+          enumerable: false,
+        });
+      }
+    } else {
+      internalsMap.set(this, {
+        message: `${message}`,
+        name: `${options}`
+      });
+    }
   }
 
   get name() {

test/parallel/test-domexception-cause.js

@@ -0,0 +1,33 @@
+'use strict';
+
+require('../common');
+const { strictEqual, deepStrictEqual } = require('assert');
+
+{
+  const domException = new DOMException('no cause', 'abc');
+  strictEqual(domException.name, 'abc');
+  strictEqual('cause' in domException, false);
+  strictEqual(domException.cause, undefined);
+}
+
+{
+  const domException = new DOMException('with undefined cause', { name: 'abc', cause: undefined });
+  strictEqual(domException.name, 'abc');
+  strictEqual('cause' in domException, true);
+  strictEqual(domException.cause, undefined);
+}
+
+{
+  const domException = new DOMException('with string cause', { name: 'abc', cause: 'foo' });
+  strictEqual(domException.name, 'abc');
+  strictEqual('cause' in domException, true);
+  strictEqual(domException.cause, 'foo');
+}
+
+{
+  const object = { reason: 'foo' };
+  const domException = new DOMException('with object cause', { name: 'abc', cause: object });
+  strictEqual(domException.name, 'abc');
+  strictEqual('cause' in domException, true);
+  deepStrictEqual(domException.cause, object);
+}