{{JSRef}}
The EvalError
object indicates an error regarding the global {{jsxref("Global_Objects/eval", "eval()")}} function.
Syntax
new EvalError([message[, fileName[, lineNumber]]])
Parameters
message
- Optional. Human-readable description of the error
fileName
{{non-standard_inline}}- Optional. The name of the file containing the code that caused the exception
lineNumber
{{non-standard_inline}}- Optional. The line number of the code that caused the exception
Description
An EvalError
is thrown when the global {{jsxref("Global_Objects/eval", "eval()")}} function is used improperly.
Properties
- {{jsxref("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 |
---|---|---|
{{SpecName('ES3')}} | {{Spec2('ES3')}} | Initial definition. |
{{SpecName('ES5.1', '#sec-15.11.6.1', 'EvalError')}} | {{Spec2('ES5.1')}} | Not used in this specification. Present for backward compatibility. |
{{SpecName('ES6', '#sec-native-error-types-used-in-this-standard-evalerror', 'EvalError')}} | {{Spec2('ES6')}} | Not used in this specification. Present for backward compatibility. |
{{SpecName('ESDraft', '#sec-native-error-types-used-in-this-standard-evalerror', 'EvalError')}} | {{Spec2('ESDraft')}} |
Browser compatibility
{{CompatibilityTable}}
Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|
Basic support | {{CompatVersionUnknown}} | {{CompatVersionUnknown}} | {{CompatVersionUnknown}} | {{CompatVersionUnknown}} | {{CompatVersionUnknown}} |
Feature | Android | Chrome for Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|---|
Basic support | {{CompatVersionUnknown}} | {{CompatVersionUnknown}} | {{CompatVersionUnknown}} | {{CompatVersionUnknown}} | {{CompatVersionUnknown}} | {{CompatVersionUnknown}} |
See also
- {{jsxref("Error")}}
- {{jsxref("EvalError.prototype")}}
- {{jsxref("Global_Objects/eval", "eval()")}}