The London Perl and Raku Workshop takes place on 26th Oct 2024. If your company depends on Perl, please consider sponsoring and/or attending.

NAME

JavaScript::V8::CommonJS - Modules/1.0 for JavaScript::V8

SYNOPSIS

use JavaScript::V8::CommonJS;

my $js = JavaScript::V8::CommonJS->new(paths => ["./modules"]);

print $js->eval('require("foo").add(4, 2)');  # prints 6

# modules/foo.js
# exports.add = function(a, b) { return a + b }

DESCRIPTION

CommonJS implementation for JavaScript::V8. Currently only Module/1.0 spec is implemented. (Passing all unit tests at https://github.com/commonjs/commonjs/tree/master/tests/modules/1.0)

CONSTRUCTOR

new

All arguments are optional.

paths

Arrayref of paths to search for modules. Default: [getcwd()].

modules

Hashref of native modules. Default: {}.

v8_params

Hashref passed directly to "new" in JavaScript::V8::Context. Default: undef.

METHODS

add_module(name => module)

Register native modules. Attempting to register a module twice is a fatal error.

$js->add_module( http => {
    get => sub { ... },
    post => sub { ... },
    ...
});

eval(js_code, source)

Evaluates javascript source code on the global context. JS exceptions are rethrown as JavaScript::V8::CommonJS::Exception instances.

$js->eval('require("program").doSomething()', "main")

The second argument is a source or filename to be reported on error messages.

eval_file(path)

$js->eval_file("main.js")

c

Returns the JavaScript::V8::Context instance.

# run v8 garbage collector
$js->c->idle_notification

LICENSE

Copyright (C) Carlos Fernando Avila Gratz.

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

AUTHOR

Carlos Fernando Avila Gratz <cafe@kreato.com.br>