EvalError

The EvalError object indicates an error regarding the global eval() function.

Syntax

new EvalError([message[, fileName[, lineNumber]]])

Parameters

message
Optional. Human-readable description of the error
fileName This API has not been standardized.
Optional. The name of the file containing the code that caused the exception
lineNumber This API has not been standardized.
Optional. The line number of the code that caused the exception

Description

An EvalError is thrown when the global eval() function is used improperly.

Properties

EvalError.prototype
Allows the addition of properties to an EvalError object.

Methods

The global EvalError contains no methods of its own, however, it does inherit some methods through the prototype chain.

EvalError instances

Properties

{{page('/en-US/docs/Web/JavaScript/Reference/Global_Objects/EvalError/prototype', 'Properties')}}

Methods

{{page('/en-US/docs/Web/JavaScript/Reference/Global_Objects/EvalError/prototype', 'Methods')}}

Examples

EvalError is not used now, and never be thrown by the runtime.

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 Status Comment
ECMAScript 3rd Edition (ECMA-262) Standard Initial definition.
ECMAScript 5.1 (ECMA-262)
The definition of 'EvalError' in that specification.
Standard Not used in this specification. Present for backward compatibility.
ECMAScript 2015 (6th Edition, ECMA-262)
The definition of 'EvalError' in that specification.
Standard Not used in this specification. Present for backward compatibility.

Browser compatibility

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help!
Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari
Basic support (Yes) (Yes) (Yes) (Yes) (Yes)
Feature Android Chrome for Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Basic support (Yes) (Yes) (Yes) (Yes) (Yes) (Yes)

See also