eval( ) — execute JavaScript code from a string


JavaScript 1.0; JScript 1.0; ECMAScript v1





A string that contains the JavaScript expression to be evaluated or the statements to be executed.


The value of the evaluated code, if any.



Indicates that code does not contain legal JavaScript.


Indicates that eval( ) was called illegally, through an identifier other than “eval”, for example. See the restrictions on this function described below.

Other exception

If the JavaScript code passed to eval( ) generates an exception, eval( ) will pass that exception on to the caller.


eval( ) is a global method that evaluates a string containing JavaScript code. If code contains an expression, eval evaluates the expression and returns its value. If code contains a JavaScript statement or statements, eval( ) executes those statements and returns the value, if any, returned by the last statement. If code does not return any value, eval( ) returns undefined. Finally, if code throws an exception, eval( ) passes that exception on to the caller.

eval( ) provides a very powerful capability to the JavaScript language, but its use is infrequent in real-world programs. Obvious uses are to write programs that act as recursive JavaScript interpreters and to write programs that dynamically generate and evaluate JavaScript code.

Most JavaScript functions and methods that expect string arguments accept arguments of other ...

Get JavaScript: The Definitive Guide, Fourth Edition now with O’Reilly online learning.

O’Reilly members experience live online training, plus books, videos, and digital content from 200+ publishers.