W3cubDocs

EvalError

The EvalError object indicates an error regarding the global eval() function. This exception is not thrown by JavaScript anymore, however the EvalError object remains for compatibility.

EvalError is a serializable object, so it can be cloned with structuredClone() or copied between Workers using postMessage().

Constructor

EvalError(): Creates a new EvalError object.

Instance properties

EvalError.prototype.message: Error message. Inherited from Error.
EvalError.prototype.name: Error name. Inherited from Error.
EvalError.prototype.cause: Error cause. Inherited from Error.
EvalError.prototype.fileName Non-standard: Path to file that raised this error. Inherited from Error.
EvalError.prototype.lineNumber Non-standard: Line number in file that raised this error. Inherited from Error.
EvalError.prototype.columnNumber Non-standard: Column number in line that raised this error. Inherited from Error.
EvalError.prototype.stack Non-standard: Stack trace. Inherited from Error.

Examples

EvalError is not used in the current ECMAScript specification and will thus not be thrown by the runtime. However, the object itself remains for backwards compatibility with earlier versions of the specification.

Creating an EvalError

try {
  throw new EvalError('Hello', 'someFile.js', 10);
} catch (e) {
  console.log(e instanceof EvalError); // true
  console.log(e.message);              // "Hello"
  console.log(e.name);                 // "EvalError"
  console.log(e.fileName);             // "someFile.js"
  console.log(e.lineNumber);           // 10
  console.log(e.columnNumber);         // 0
  console.log(e.stack);                // "@Scratchpad/2:2:9\n"
}

Specifications

Specification
ECMAScript Language Specification # sec-native-error-types-used-in-this-standard-evalerror

Browser compatibility

	Desktop						Mobile						Server
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	WebView Android	Chrome Android	Firefox for Android	Opera Android	Safari on IOS	Samsung Internet	Deno	Node.js
`EvalError`	1	12	1	5.5	5	1	4.4	18	4	10.1	1	1.0	1.0	0.10.0
`EvalError`	1	12	1	5.5	5	1	4.4	18	4	10.1	1	1.0	1.0	0.10.0
`serializable_object`	77	79	103 ["Version 103 serializable properties: `name`, `message`, `cause`, `fileName`, `lineNumber` and `columnNumber`.", "Version 104 also serializes `stack` in `window.postMessage()` and `structuredClone()`."]	No	64	No	77	77	103 ["Version 103 serializable properties: `name`, `message`, `cause`, `fileName`, `lineNumber` and `columnNumber`.", "Version 104 also serializes `stack` in `window.postMessage()` and `structuredClone()`."]	55	No	12.0	No	No