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'seval
method, which runs global code). Variables created withvar
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 explicitreturn
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'sparse
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.