Interface Parser


  • public interface Parser
    Represents nashorn ECMAScript parser instance.
    Since:
    9
    • Method Detail

      • parse

        CompilationUnitTree parse​(java.io.File file,
                                  DiagnosticListener listener)
                           throws java.io.IOException,
                                  NashornException
        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:
        java.lang.NullPointerException - if file is null
        java.io.IOException - if parse source read fails
        NashornException - is thrown if no listener is supplied and parser encounters error
      • parse

        CompilationUnitTree parse​(java.nio.file.Path path,
                                  DiagnosticListener listener)
                           throws java.io.IOException,
                                  NashornException
        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:
        java.lang.NullPointerException - if path is null
        java.io.IOException - if parse source read fails
        NashornException - is thrown if no listener is supplied and parser encounters error
      • parse

        CompilationUnitTree parse​(java.net.URL url,
                                  DiagnosticListener listener)
                           throws java.io.IOException,
                                  NashornException
        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:
        java.lang.NullPointerException - if url is null
        java.io.IOException - if parse source read fails
        NashornException - is thrown if no listener is supplied and parser encounters error
      • parse

        CompilationUnitTree parse​(java.lang.String name,
                                  java.io.Reader reader,
                                  DiagnosticListener listener)
                           throws java.io.IOException,
                                  NashornException
        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:
        java.lang.NullPointerException - if name or reader is null
        java.io.IOException - if parse source read fails
        NashornException - is thrown if no listener is supplied and parser encounters error
      • parse

        CompilationUnitTree parse​(java.lang.String name,
                                  java.lang.String code,
                                  DiagnosticListener listener)
                           throws NashornException
        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:
        java.lang.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
        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:
        java.lang.NullPointerException - if scriptObj is null
        NashornException - is thrown if no listener is supplied and parser encounters error
      • create

        static Parser create​(java.lang.String... options)
                      throws java.lang.IllegalArgumentException
        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:
        java.lang.NullPointerException - if options array or any of its element is null
        java.lang.IllegalArgumentException - on unsupported option value.