NAME

JE::Code - ECMAScript parser and code executor for JE

SYNOPSIS

  use JE;

  $j = new JE;

  $code = $j->compile('1+1'); # returns a JE::Code object

  $code->execute;

METHODS

$code->execute($this, $scope, $code_type);

The execute method of a parse tree executes it. All the arguments are optional.

The first argument will be the 'this' value of the execution context. The global object will be used if it is omitted or undef.

The second argument is the scope chain. A scope chain containing just the global object will be used if it is omitted or undef.

The third arg indicates the type of code. 0 or undef indicates global code. 1 means eval code (code called by JavaScript's eval function, which has nothing to do with JE's eval method, which runs global code). Variables created with var and function declarations inside eval code can be deleted, whereas such variables in global or function code cannot. A value of 2 means function code, which requires an explicit return statement for a value to be returned.

If an error occurs, undef will be returned and $@ will contain the error message. If no error occurs, $@ will be a null string.

$code->set_global( $thing )

You can transfer a JE::Code object to another JavaScript environment by setting the global object this way. You can also set it to undef, if, for instance, you want to serialise the compiled code without serialising the entire JS environment. If you do that, you'll need to set the global object again before you can use the code object.

FUNCTIONS

JE::Code::add_line_number($message, $code_object, $position)

WARNING: The parameter list is still subject to change.

This routine append a string such as 'at file, line 76.' to the error message passed to it, unless it ends with a line break already.

$code_object is a code object as returned by JE's or JE::Parser's parse method. If it is omitted, the current value of $JE::Code::code will be used (this is set while JS code is running). If $JE::Code::code turns out to be undefined, then $message will be returned unchanged (this is subject to change; later I might make it use Carp to add a Perl file and line number).

$position is the position within the source code, which will be used to determine the line number. If this is omitted, $JE::Code::pos will be used.

EXPORTS

add_line_number can optionally be exported.

SEE ALSO

JE