JavaScript(3pm)

NAME

JavaScript - Perl extension for executing embedded JavaScript

SYNOPSIS

use JavaScript;

my $rt = JavaScript::Runtime->new();
my $cx = $rt->create_context();

$cx->bind_function(write => sub { print @_; });

$cx->eval(q/
  for (i = 99; i > 0; i--) {
      write(i + " bottle(s) of beer on the wall, " + i + " bottle(s) of beer\n");
      write("Take 1 down, pass it around, ");
      if (i > 1) {
          write((i - 1) + " bottle(s) of beer on the wall.");
      }
      else {
          write("No more bottles of beer on the wall!");
      }
  }
/);

DESCRIPTION

Always thought JavaScript was for web-applications only? well, think
again...

This modules gives you the power of embedded JavaScript in your Perl
applications. You can write your subroutines, classes and so forth in
Perl and make them callable from JavaScript. Variables such as
primitive types, objects and functions are automagically converted
between the different environments. If you return a JavaScript function you can call it as a normal code-reference from Perl.

JavaScript is a great as an embedded language because it has no I/O, no IPC and pretty much anything else that can interfer with the system.
It's also an easy yet powerful language that zillions of developers
worldwide knows.

Note that this module is not a JavaScript compiler/interpreter written in Perl but an interface to the SpiderMonkey engine used in the
Mozilla-family of browsers.

INTERFACE

CLASS METHODS: create_runtime ( ... )
Shortcut for "JavaScript::Runtime-"new(...)>.; get_engine_version
In scalar context it returns a string describing the engine such as "JavaScript-C 1.5 2004-09-24".

In list context it returns the separate parts of the string engine, version and date of build.; does_support_utf8
does_handle_utf8
Returns a true value if SpiderMonkey is compiled with support for
UTF8 strings and if we're using it. does_handle_utf8 is also supported for backwards compatibility.; does_support_e4x
Returns a true value if we have compiled support for E4X.; does_support_threading
Returns a true value if we have compiled support for threading.; supports ( @features )
Checks if all features given in @features are present. Is case insensitive. Supported keys are e4x, utf8 and threading. Extensions to this module may provide additional keys by implementing a method that begins with "does_support_".

SUPPORT

There is a mailing-list available at
<http://lists.cpan.org/showlist.cgi?name=perl-javascript>.

You may subscribe to the list by sending an empty e-mail to
"perl-javascript-subscribe@perl.org"

CREDITS

See CREDITS

BUGS AND LIMITATIONS

Please report any bugs or feature requests to
"bug-javascript@rt.cpan.org", or through the web interface at
<http://rt.cpan.org>.

AUTHOR

Claes Jakobsson "<claesjac@cpan.org>"

LICENCE AND COPYRIGHT

This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself. See perlartistic.

DISCLAIMER OF WARRANTY

BECAUSE THIS SOFTWARE IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY FOR THE SOFTWARE, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT
WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER
PARTIES PROVIDE THE SOFTWARE "AS IS" WITHOUT WARRANTY OF ANY KIND,
EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE SOFTWARE IS WITH
YOU. SHOULD THE SOFTWARE PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL
NECESSARY SERVICING, REPAIR, OR CORRECTION.

IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR
REDISTRIBUTE THE SOFTWARE AS PERMITTED BY THE ABOVE LICENCE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL, OR
CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE
SOFTWARE (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING
RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A
FAILURE OF THE SOFTWARE TO OPERATE WITH ANY OTHER SOFTWARE), EVEN IF
SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

docs.sk

comprehensive documentation repository

Most Viewed