Module jdk.scripting.nashorn

Package jdk.nashorn.api.tree

Interface Parser

@Deprecated(since="11",
            forRemoval=true)
public interface Parser

Deprecated, for removal: This API element is subject to removal in a future version.

Nashorn JavaScript script engine and APIs, and the jjs tool are deprecated with the intent to remove them in a future release.

Represents nashorn ECMAScript parser instance.

Since:

9

Method Summary

Modifier and Type	Method	Description
static Parser	create(String... options)	Deprecated, for removal: This API element is subject to removal in a future version. Factory method to create a new instance of Parser.
CompilationUnitTree	parse(File file, DiagnosticListener listener)	Deprecated, for removal: This API element is subject to removal in a future version. Parses the source file and returns compilation unit tree
CompilationUnitTree	parse(String name, Reader reader, DiagnosticListener listener)	Deprecated, for removal: This API element is subject to removal in a future version. Parses the reader and returns compilation unit tree
CompilationUnitTree	parse(String name, String code, DiagnosticListener listener)	Deprecated, for removal: This API element is subject to removal in a future version. Parses the string source and returns compilation unit tree
CompilationUnitTree	parse(URL url, DiagnosticListener listener)	Deprecated, for removal: This API element is subject to removal in a future version. Parses the source url and returns compilation unit tree
CompilationUnitTree	parse(Path path, DiagnosticListener listener)	Deprecated, for removal: This API element is subject to removal in a future version. Parses the source Path and returns compilation unit tree
CompilationUnitTree	parse(ScriptObjectMirror scriptObj, DiagnosticListener listener)	Deprecated, for removal: This API element is subject to removal in a future version. Parses the source from script object and returns compilation unit tree

Method Detail

parse

CompilationUnitTree parse(File file,
                          DiagnosticListener listener)
                   throws IOException,
                          NashornException

Deprecated, for removal: This API element is subject to removal in a future version.

Parses the source file and returns compilation unit tree

Parameters:

file - source file to parse

listener - to receive diagnostic messages from the parser. This can be null. if null is passed, a NashornException is thrown on the first parse error.

Returns:

compilation unit tree

Throws:

NullPointerException - if file is null

IOException - if parse source read fails

NashornException - is thrown if no listener is supplied and parser encounters error

parse

CompilationUnitTree parse(Path path,
                          DiagnosticListener listener)
                   throws IOException,
                          NashornException

Deprecated, for removal: This API element is subject to removal in a future version.

Parses the source Path and returns compilation unit tree

Parameters:

path - source Path to parse

listener - to receive diagnostic messages from the parser. This can be null. if null is passed, a NashornException is thrown on the first parse error.

Returns:

compilation unit tree

Throws:

NullPointerException - if path is null

IOException - if parse source read fails

NashornException - is thrown if no listener is supplied and parser encounters error

parse

CompilationUnitTree parse(URL url,
                          DiagnosticListener listener)
                   throws IOException,
                          NashornException

Deprecated, for removal: This API element is subject to removal in a future version.

Parses the source url and returns compilation unit tree

Parameters:

url - source file to parse

listener - to receive diagnostic messages from the parser. This can be null. if null is passed, a NashornException is thrown on the first parse error.

Returns:

compilation unit tree

Throws:

NullPointerException - if url is null

IOException - if parse source read fails

NashornException - is thrown if no listener is supplied and parser encounters error

parse

CompilationUnitTree parse(String name,
                          Reader reader,
                          DiagnosticListener listener)
                   throws IOException,
                          NashornException

Deprecated, for removal: This API element is subject to removal in a future version.

Parses the reader and returns compilation unit tree

Parameters:

name - name of the source file to parse

reader - from which source is read

listener - to receive diagnostic messages from the parser. This can be null. if null is passed, a NashornException is thrown on the first parse error.

Returns:

compilation unit tree

Throws:

NullPointerException - if name or reader is null

IOException - if parse source read fails

NashornException - is thrown if no listener is supplied and parser encounters error

parse

CompilationUnitTree parse(String name,
                          String code,
                          DiagnosticListener listener)
                   throws NashornException

Deprecated, for removal: This API element is subject to removal in a future version.

Parses the string source and returns compilation unit tree

Parameters:

name - of the source

code - string source

listener - to receive diagnostic messages from the parser. This can be null. if null is passed, a NashornException is thrown on the first parse error.

Returns:

compilation unit tree

Throws:

NullPointerException - if name or code is null

NashornException - is thrown if no listener is supplied and parser encounters error

parse

CompilationUnitTree parse(ScriptObjectMirror scriptObj,
                          DiagnosticListener listener)
                   throws NashornException

Deprecated, for removal: This API element is subject to removal in a future version.

Parses the source from script object and returns compilation unit tree

Parameters:

scriptObj - script object whose script and name properties are used for script source

listener - to receive diagnostic messages from the parser. This can be null. if null is passed, a NashornException is thrown on the first parse error.

Returns:

compilation unit tree

Throws:

NullPointerException - if scriptObj is null

NashornException - is thrown if no listener is supplied and parser encounters error

create

static Parser create(String... options)
              throws IllegalArgumentException

Deprecated, for removal: This API element is subject to removal in a future version.

Factory method to create a new instance of Parser.

Parameters:

options - configuration options to initialize the Parser. Currently the following options are supported:

"--const-as-var"

treat "const" declaration as "var"

"-dump-on-error" or "-doe"

dump stack trace on error

"--empty-statements"

include empty statement nodes

"--no-syntax-extensions" or "-nse"

disable ECMAScript syntax extensions

"-scripting"

enable scripting mode extensions

"-strict"

enable ECMAScript strict mode

"--language=es6"

enable ECMAScript 6 parsing mode

"--es6-module"

enable ECMAScript 6 module parsing mode. This option implies --language=es6

Returns:

a new Parser instance.

Throws:

NullPointerException - if options array or any of its element is null

IllegalArgumentException - on unsupported option value.