You are here: Rhino project page > JavaScript Shell
The JavaScript shell provides a simple way to run scripts in batch mode or an interactive environment for exploratory programming.
java org.mozilla.javascript.tools.shell.Main [options] script-filename-or-url [script-arguments]
where options are:
-e script-source
-f script-filename-or-url
-opt optLevel
-O optLevel
-version versionNumber
-strict
-continuations
If the shell is invoked with the system property rhino.use_java_policy_security set to true and with a security manager installed, the shell restricts scripts permissions based on their URLs according to Java policy settings. This is available only if JVM implements Java2 security model.
Scripts executing in the shell have access to some additional properties of the top-level object.
arguments
object is an array containing the
strings of all the arguments given at the command line when the
shell was invoked.serialize
.this
object of its invocation.Here the shell is invoked three times from the command line. (The system
command prompt is shown as $
.) The first invocation executes a
script specified on the command line itself. The next invocation has no
arguments, so the shell goes into interactive mode, reading and evaluating
each line as it is typed in. Finally, the last invocation executes a script
from a file and accesses arguments to the script itself.
$ java org.mozilla.javascript.tools.shell.Main -e print('hi') hi $ java org.mozilla.javascript.tools.shell.Main js> print('hi') hi js> 6*7 42 js> function f() { return a; } js> var a = 34; js> f() 34 js> quit() $ cat echo.js for (i in arguments) { print(arguments[i]) } $ java org.mozilla.javascript.tools.shell.Main echo.js foo bar foo bar $
The following example creates 2 threads via
spawn
and uses sync
to create a synchronized version of the function
test
.
js> function test(x) { print("entry"); java.lang.Thread.sleep(x*1000); print("exit"); } js> var o = { f : sync(test) }; js> spawn(function() {o.f(5);}); Thread[Thread-0,5,main] entry js> spawn(function() {o.f(5);}); Thread[Thread-1,5,main] js> exit entry exit
Here is few examples of invoking runCommand
under Linux.
js> runCommand('date') Thu Jan 23 16:49:36 CET 2003 0 // Using input option to provide process input js> runCommand("sort", {input: "c\na\nb"}) a b c 0 js> // Demo of output and err options js> var opt={input: "c\na\nb", output: 'Sort Output:\n'} js> runCommand("sort", opt) 0 js> print(opt.output) Sort Output: a b c js> var opt={input: "c\na\nb", output: 'Sort Output:\n', err: ''} js> runCommand("sort", "--bad-arg", opt) 2 js> print(opt.err) /bin/sort: unrecognized option `--bad-arg' Try '/bin/sort --help' for more information. js> runCommand("bad_command", "--bad-arg", opt) js: "<stdin>", line 18: uncaught JavaScript exception: java.io.IOException: bad_command: not found js> // Passing explicit environment to the system shell js> runCommand("sh", "-c", "echo $env1 $env2", { env: {env1: 100, env2: 200}}) 100 200 0 js> // Use args option to provide additional command arguments js> var arg_array = [1, 2, 3, 4]; js> runCommand("echo", { args: arg_array}) 1 2 3 4 0
Examples for Windows are similar:
js> // Invoke shell command js> runCommand("cmd", "/C", "date /T") 27.08.2005 0 js> // Run sort collectiong the output js> var opt={input: "c\na\nb", output: 'Sort Output:\n'} js> runCommand("sort", opt) 0 js> print(opt.output) Sort Output: a b c js> // Invoke notepad and wait until it exits js> runCommand("notepad") 0