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 powerfull 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
- 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_handle_utf8
-
Returns a true value if SpiderMonkey is compiled with support for UTF8 strings and if we're using it.
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 & THANKS
Chia-liang Kao, Tom Insam and James Duncan at Fotango Ltd. for fixing even more stuff that I could ever imagine such as error handling, returing javascript functions to Perl etc.
Joost Diepenmaat for fixing lots of stuff.
sungo for providing Makefile.Pl fixes for Gentoo Linux.
G. Allen Morris III for fixing error handling.
Mozilla.org and Netscape for the excellent SpiderMonkey engine.
#perl on irc.infobot.org for feedback and help.
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 Jacobsson <claesjac@cpan.org>
LICENCE AND COPYRIGHT
Copyright (c) 2001 - 2006, Claes Jacobsson <claesjac@cpan.org>. All rights reserved.
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.