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 Details

    • parse

      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

      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

      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

      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

      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.