.\" Copyright (c) 1994, 2019, Oracle and/or its affiliates. All rights reserved.
.\" DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
.\"
.\" This code is free software; you can redistribute it and/or modify it
.\" under the terms of the GNU General Public License version 2 only, as
.\" published by the Free Software Foundation.
.\"
.\" This code is distributed in the hope that it will be useful, but WITHOUT
.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
.\" FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
.\" version 2 for more details (a copy is included in the LICENSE file that
.\" accompanied this code).
.\"
.\" You should have received a copy of the GNU General Public License version
.\" 2 along with this work; if not, write to the Free Software Foundation,
.\" Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
.\"
.\" Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
.\" or visit www.oracle.com if you need additional information or have any
.\" questions.
.\"
.\" Automatically generated by Pandoc 2.3.1
.\"
.TH "JJS" "1" "2018" "JDK 13" "JDK Commands"
.hy
.SH NAME
.PP
jjs \- command\-line tool to invoke the Nashorn engine
.SH SYNOPSIS
.PP
\f[B]Note:\f[R] The \f[CB]jjs\f[R] tool and the Nashorn engine are
deprecated in JDK 11 in preparation for removal in a future release.
.PP
\f[CB]jjs\f[R] [\f[I]options\f[R]] \f[I]script\-files\f[R] [\f[CB]\-\-\f[R]
\f[I]arguments\f[R]]
.TP
.B \f[I]options\f[R]
This represents one or more options of the \f[CB]jjs\f[R] command,
separated by spaces.
See \f[B]Options for the jjs Command\f[R].
.RS
.RE
.TP
.B \f[I]script\-files\f[R]
This represents one or more script files that you want to interpret
using the Nashorn engine, separated by spaces.
If no files are specified, then an interactive shell is started.
.RS
.RE
.TP
.B \f[I]arguments\f[R]
All values after the double hyphen marker (\f[CB]\-\-\f[R]) are passed
through to the script or the interactive shell as arguments.
These values can be accessed by using the \f[CB]arguments\f[R] property.
.RS
.RE
.SH DESCRIPTION
.PP
The \f[CB]jjs\f[R] command\-line tool is used to invoke the Nashorn
engine.
You can use it to interpret one or several script files, or to run an
interactive shell.
.SH OPTIONS FOR THE JJS COMMAND
.PP
The options of the \f[CB]jjs\f[R] command control the conditions under
which scripts are interpreted by Nashorn engine.
.TP
.B \f[CB]\-D\f[R]\f[I]name\f[R]\f[CB]=\f[R]\f[I]value\f[R]
Sets a system property to be passed to the script by assigning a value
to a property name.
The following example shows how to invoke Nashorn engine in interactive
mode and assign \f[CB]myValue\f[R] to the property named \f[CB]myKey\f[R]:
.RS
.IP
.nf
\f[CB]
>>\ jjs\ \-DmyKey=myValue
jjs>\ java.lang.System.getProperty("myKey")
myValue
jjs>
\f[R]
.fi
.PP
This option can be repeated to set multiple properties.
.RE
.TP
.B \f[CB]\-\-add\-modules\f[R] \f[I]modules\f[R]
Specifies the root user Java modules.
.RS
.RE
.TP
.B \f[CB]\-cp\f[R] \f[I]path\f[R] or \f[CB]\-classpath\f[R] \f[I]path\f[R]
Specifies the path to the supporting class files.
To set multiple paths, the option can be repeated, or you can separate
each path with the following character:
.RS
.IP \[bu] 2
\f[B]Oracle Solaris, Linux, and OS X:\f[R] Colon (\f[CB]:\f[R])
.IP \[bu] 2
\f[B]Windows:\f[R] Semicolon (\f[CB];\f[R])
.RE
.TP
.B \f[CB]\-doe=\f[R][\f[CB]true\f[R]|\f[CB]false\f[R]] or \f[CB]\-dump\-on\-error=\f[R][\f[CB]true\f[R]|\f[CB]false\f[R]]
Provides a full stack trace when an error occurs.
By default, only a brief error message is printed.
The default parameter is \f[CB]false\f[R].
.RS
.RE
.TP
.B \f[CB]\-fv=\f[R][\f[CB]true\f[R]|\f[CB]false\f[R]] or \f[CB]\-fullversion=\f[R][\f[CB]true\f[R]|\f[CB]false\f[R]]
Prints the full Nashorn version string.
The default parameter is \f[CB]false\f[R].
.RS
.RE
.TP
.B \f[CB]\-fx=\f[R][\f[CB]true\f[R]|\f[CB]false\f[R]]
Launches the script as a JavaFX application.
The default parameter is \f[CB]false\f[R].
.RS
.PP
\f[B]Note:\f[R]
.PP
You must explicitly add the JavaFX modules to launch the script as a
JavaFX application.
The following example specifies the location of the JavaFX modules and
adds them with the \f[CB]\-\-module\-path\f[R] and
\f[CB]\-\-add\-modules\f[R] options:
.IP
.nf
\f[CB]
jjs\ \-fx\ \-\-module\-path\ /SOMEDIR/javafx\-sdk\-11/lib\ \-\-add\-modules\ javafx.controls\ HelloWorld.js
\f[R]
.fi
.PP
The following example uses the \f[CB]jlink\f[R] command to create a custom
runtime image that contains the JavaFX modules.
The example then launches a script as a JavaFX application without
specifying the JavaFX modules in the \f[CB]jjs\f[R] command:
.IP
.nf
\f[CB]
jlink\ \-\-module\-path\ /SOMEDIR/javafx\-jmods\-11\ \-\-add\-modules\ jdk.scripting.nashorn,jdk.scripting.nashorn.shell,javafx.controls\ \-\-output\ /SOMEDIR/myjdk

/SOMEDIR/myjdk/bin/jjs\ \-fx\ HelloWorld.js
\f[R]
.fi
.PP
If you don\[aq]t explicitly specify the JavaFX modules, then the
\f[CB]jjs\f[R] command prints a message and exits:
.IP
.nf
\f[CB]
jjs\ \-fx\ HelloWorld.js

JavaFX\ is\ not\ available.
\f[R]
.fi
.RE
.TP
.B \f[CB]\-h\f[R] or \f[CB]\-help\f[R]
Prints the list of options and their descriptions.
.RS
.RE
.TP
.B \f[CB]\-\-language=\f[R][\f[CB]es5\f[R]|\f[CB]es6\f[R]]
Specifies the ECMAScript language version.
The default version is ES5.
.RS
.RE
.TP
.B \f[CB]\-\-module\-path\f[R] \f[I]path\f[R]
Specifies where to find user Java modules.
.RS
.RE
.TP
.B \f[CB]\-ot=\f[R][\f[CB]true\f[R]|\f[CB]false\f[R]] or \f[CB]\-optimistic\-types=\f[R][\f[CB]true\f[R]|\f[CB]false\f[R]]
Enables or disables optimistic type assumptions with deoptimizing
recompilation.
This makes the compiler try, for any program symbol whose type can\[aq]t
be proven at compile time, to type it as narrowly and primitively as
possible.
If the runtime encounters an error because the symbol type is too
narrow, then a wider method is generated until a steady stage is
reached.
While this produces as optimal Java bytecode as possible, erroneous type
guesses will lead to longer warmup.
Optimistic typing is currently enabled by default, but it can be
disabled for faster startup performance.
The default parameter is \f[CB]true\f[R].
.RS
.RE
.TP
.B \f[CB]\-scripting=\f[R][\f[CB]true\f[R]|\f[CB]false\f[R]]
Enables a shell scripting features.
The default parameter is \f[CB]true\f[R].
.RS
.RE
.TP
.B \f[CB]\-strict=\f[R][\f[CB]true\f[R]|\f[CB]false\f[R]]
Enables a strict mode, which enforces stronger adherence to the standard
(ECMAScript Edition 5.1), making it easier to detect common coding
errors.
The default parameter is \f[CB]false\f[R].
.RS
.RE
.TP
.B \f[CB]\-t=\f[R]\f[I]zone\f[R] or \f[CB]\-timezone=\f[R]\f[I]zone\f[R]
Sets the specified time zone for script execution.
It overrides the time zone set in the OS and used by the \f[CB]Date\f[R]
object.
The default \f[I]zone\f[R] is \f[CB]America/Los_Angeles\f[R].
.RS
.RE
.TP
.B \f[CB]\-v=\f[R][\f[CB]true\f[R]|\f[CB]false\f[R]] or\f[CB]\-version=\f[R][\f[CB]true\f[R]|\f[CB]false\f[R]]
Prints the Nashorn version string.
The default parameter is \f[CB]false\f[R].
.RS
.RE
.SH EXAMPLE OF RUNNING A SCRIPT WITH NASHORN
.IP
.nf
\f[CB]
jjs\ script.js
\f[R]
.fi
.SH EXAMPLE OF RUNNING NASHORN IN INTERACTIVE MODE
.IP
.nf
\f[CB]
>>\ jjs
jjs>\ println("Hello,\ World!")
Hello,\ World!
jjs>\ quit()
>>
\f[R]
.fi
.SH EXAMPLE OF PASSING ARGUMENTS TO NASHORN
.IP
.nf
\f[CB]
>>\ jjs\ \-\-\ a\ b\ c
jjs>\ arguments.join(",\ ")
a,\ b,\ c
jjs>
\f[R]
.fi