Documentation Contents
Java Platform, Standard Edition Tools Reference
Contents Previous Next

# jrunscript

Runs a command-line script shell that supports interactive and batch modes. This command is experimental and unsupported.

## Synopsis

jrunscript [options] [arguments]

options

  The command-line options. See Options.

arguments

  Arguments, when used, follow immediately after options or the command name. See Arguments.

## Description

The `jrunscript` command is a language-independent command-line script shell. The `jrunscript` command supports both an interactive (read-eval-print) mode and a batch (`-f` option) mode of script execution. By default, JavaScript is the language used, but the `-l` option can be used to specify a different language. By using Java to scripting language communication, the `jrunscript` command supports an exploratory programming style.

## Options

-classpath path

  Indicate where any class files are that the script needs to access.

-cp path

  Same as `-classpath` `path`..

-Dname=value

  Sets a Java system property.

-Jflag

  Passes `flag` directly to the Java Virtual Machine where the `jrunscript` command is running.

-I language

  Uses the specified scripting language. By default, JavaScript is used. To use other scripting languages, you must specify the corresponding script engine's JAR file with the `-cp` or `-classpath` option.

-e script

  Evaluates the specified script. This option can be used to run one-line scripts that are specified completely on the command line.

-encoding encoding

  Specifies the character encoding used to read script files.

-f script-file

  Evaluates the specified script file (batch mode).

-f -

  Reads and evaluates a script from standard input (interactive mode).

-help

  Displays a help message and exits.

-?

  Displays a help message and exits.

-q

  Lists all script engines available and exits.

## Arguments

If arguments are present and if no `-e` or `-f` option is used, then the first argument is the script file and the rest of the arguments, if any, are passed to the script. If arguments and `-e` or the `-f` option are used, then all arguments are passed to the script. If arguments, `-e` and `-f` are missing, then interactive mode is used. Script arguments are available to a script in an engine variable named `arguments` of type `String` array.

## Examples

### Execute Inline Scripts

    jrunscript -e "print('hello world')"
    jrunscript -e "cat('http://www.example.com')"

### Use Specified Language and Evaluate the Script File

    jrunscript -l js -f test.js

### Interactive Mode

    jrunscript
    js> print('Hello World\n');
    Hello World
    js> 34 + 55
    89.0
    js> t = new java.lang.Thread(function() { print('Hello World\n'); })
    Thread[Thread-0,5,main]
    js> t.start()
    js> Hello World

    js>

### Run Script File with Script Arguments

The test.js file is the script file. The `arg1`, `arg2` and `arg3` arguments are passed to the script. The script can access these arguments with an arguments array.

    jrunscript test.js arg1 arg2 arg3

## See Also

If JavaScript is used, then before it evaluates a user defined script, the `jrunscript` command initializes certain built-in functions and objects, which are documented in the API Specification for jrunscript JavaScript built-ins:

`http://docs.oracle.com/javase/7/docs/technotes/tools/share/jsdocs/overview-summary.html`

Contents Previous Next

Copyright © 1993, 2026, Oracle and/or its affiliates. All rights reserved.
Contact Us