org.mozilla.javascript.ast

## Class AstRoot

- java.lang.Object
- - org.mozilla.javascript.Node
  - - org.mozilla.javascript.ast.AstNode
    - - org.mozilla.javascript.ast.Jump
      - - org.mozilla.javascript.ast.Scope
        - - org.mozilla.javascript.ast.ScriptNode
          - - org.mozilla.javascript.ast.AstRoot

- All Implemented Interfaces:
    java.lang.Comparable<AstNode>, java.lang.Iterable<Node>

      public class AstRoot
      extends ScriptNode

  Node for the root of a parse tree. It contains the statements and functions in the script, and a list of `Comment` nodes associated with the script as a whole. Node type is `Token.SCRIPT`.

  Note that the tree itself does not store errors. To collect the parse errors and warnings, pass an `ErrorReporter` to the `Parser` via the `CompilerEnvirons`.

- - ### Nested Class Summary

    - ### Nested classes/interfaces inherited from class org.mozilla.javascript.ast.AstNode

      `AstNode.DebugPrintVisitor, AstNode.PositionComparator`

    - ### Nested classes/interfaces inherited from class org.mozilla.javascript.Node

      `Node.NodeIterator`

  - ### Field Summary

    - ### Fields inherited from class org.mozilla.javascript.ast.Scope

      `parentScope, symbolTable, top`

    - ### Fields inherited from class org.mozilla.javascript.ast.Jump

      `target`

    - ### Fields inherited from class org.mozilla.javascript.ast.AstNode

      `length, parent, position`

    - ### Fields inherited from class org.mozilla.javascript.Node

      `ARROW_FUNCTION_PROP, ATTRIBUTE_FLAG, BOTH, CASEARRAY_PROP, CATCH_SCOPE_PROP, CONTROL_BLOCK_PROP, DECR_FLAG, DESCENDANTS_FLAG, DESTRUCTURING_ARRAY_LENGTH, DESTRUCTURING_NAMES, DESTRUCTURING_PARAMS, DESTRUCTURING_SHORTHAND, DIRECTCALL_PROP, END_DROPS_OFF, END_RETURNS, END_RETURNS_VALUE, END_UNREACHED, END_YIELDS, EXPRESSION_CLOSURE_PROP, first, FUNCTION_PROP, GENERATOR_END_PROP, INCRDECR_PROP, ISNUMBER_PROP, JSDOC_PROP, LABEL_ID_PROP, last, LAST_PROP, LEFT, lineno, LOCAL_BLOCK_PROP, LOCAL_PROP, MEMBER_TYPE_PROP, NAME_PROP, next, NON_SPECIALCALL, OBJECT_IDS_PROP, PARENTHESIZED_PROP, POST_FLAG, PROPERTY_FLAG, propListHead, REGEXP_PROP, RIGHT, SKIP_INDEXES_PROP, SPECIALCALL_EVAL, SPECIALCALL_PROP, SPECIALCALL_WITH, TARGETBLOCK_PROP, type, VARIABLE_PROP`

  - ### Constructor Summary

    Constructors
    Constructor and Description
    `AstRoot()`
    `AstRoot(int pos)`

  - ### Method Summary

    All Methods Instance Methods Concrete Methods
    Modifier and Type | Method and Description
    --- | ---
    `void` | `addComment(Comment comment)` Add a comment to the comment set.
    `void` | `checkParentLinks()` Debugging function to check that the parser has set the parent link for every node in the tree.
    `java.lang.String` | `debugPrint()` A debug-printer that includes comments (at the end).
    `java.util.SortedSet<Comment>` | `getComments()` Returns comment set
    `void` | `setComments(java.util.SortedSet<Comment> comments)` Sets comment list, and updates the parent of each entry to point to this node.
    `java.lang.String` | `toSource(int depth)` Emits source code for this node.
    `void` | `visitAll(NodeVisitor visitor)` Visits the AST nodes, then the comment nodes.
    `void` | `visitComments(NodeVisitor visitor)` Visits the comment nodes in the order they appear in the source code.

    - ### Methods inherited from class org.mozilla.javascript.ast.ScriptNode

      `addFunction, addRegExp, flattenSymbolTable, getBaseLineno, getCompilerData, getEncodedSource, getEncodedSourceEnd, getEncodedSourceStart, getEndLineno, getFunctionCount, getFunctionNode, getFunctions, getIndexForNameNode, getNextTempName, getParamAndVarConst, getParamAndVarCount, getParamAndVarNames, getParamCount, getParamOrVarName, getRegexpCount, getRegexpFlags, getRegexpString, getSourceName, getSymbols, isInStrictMode, setBaseLineno, setCompilerData, setEncodedSource, setEncodedSourceBounds, setEncodedSourceEnd, setEncodedSourceStart, setEndLineno, setInStrictMode, setSourceName, setSymbols, visit`

    - ### Methods inherited from class org.mozilla.javascript.ast.Scope

      `addChildScope, clearParentScope, getChildScopes, getDefiningScope, getParentScope, getStatements, getSymbol, getSymbolTable, getTop, joinScopes, putSymbol, replaceWith, setParentScope, setSymbolTable, setTop, splitScope`

    - ### Methods inherited from class org.mozilla.javascript.ast.Jump

      `getContinue, getDefault, getFinally, getJumpStatement, getLoop, setContinue, setDefault, setFinally, setJumpStatement, setLoop`

    - ### Methods inherited from class org.mozilla.javascript.ast.AstNode

      `addChild, assertNotNull, codeBug, compareTo, depth, getAbsolutePosition, getAstRoot, getEnclosingFunction, getEnclosingScope, getLength, getLineno, getParent, getPosition, hasSideEffects, makeIndent, operatorToString, printList, setBounds, setLength, setParent, setPosition, setRelative, shortName, toSource`

    - ### Methods inherited from class org.mozilla.javascript.Node

      `addChildAfter, addChildBefore, addChildrenToBack, addChildrenToFront, addChildToBack, addChildToFront, getChildBefore, getDouble, getExistingIntProp, getFirstChild, getIntProp, getJsDoc, getJsDocNode, getLastChild, getLastSibling, getNext, getProp, getScope, getString, getType, hasChildren, hasConsistentReturnUsage, iterator, labelId, labelId, newNumber, newString, newString, newTarget, putIntProp, putProp, removeChild, removeChildren, removeProp, replaceChild, replaceChildAfter, resetTargets, setDouble, setJsDocNode, setLineno, setScope, setString, setType, toString, toStringTree`

    - ### Methods inherited from class java.lang.Object

      `clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait`

    - ### Methods inherited from interface java.lang.Iterable

      `forEach, spliterator`

- - ### Constructor Detail

    - #### AstRoot

          public AstRoot()

    - #### AstRoot

          public AstRoot(int pos)

  - ### Method Detail

    - #### getComments

          public java.util.SortedSet<Comment> getComments()

      Returns comment set
      Returns:
        comment set, sorted by start position. Can be `null`.

    - #### setComments

          public void setComments(java.util.SortedSet<Comment> comments)

      Sets comment list, and updates the parent of each entry to point to this node. Replaces any existing comments.
      Parameters:
        `comments` - comment list. can be `null`.

    - #### addComment

          public void addComment(Comment comment)

      Add a comment to the comment set.
      Parameters:
        `comment` - the comment node.
      Throws:
        `java.lang.IllegalArgumentException` - if comment is `null`

    - #### visitComments

          public void visitComments(NodeVisitor visitor)

      Visits the comment nodes in the order they appear in the source code. The comments are not visited by the `ScriptNode.visit(org.mozilla.javascript.ast.NodeVisitor)` function - you must use this function to visit them.
      Parameters:
        `visitor` - the callback object. It is passed each comment node. The return value is ignored.

    - #### visitAll

          public void visitAll(NodeVisitor visitor)

      Visits the AST nodes, then the comment nodes. This method is equivalent to calling `ScriptNode.visit(org.mozilla.javascript.ast.NodeVisitor)`, then `visitComments(org.mozilla.javascript.ast.NodeVisitor)`. The return value is ignored while visiting comment nodes.
      Parameters:
        `visitor` - the callback object.

    - #### toSource

          public java.lang.String toSource(int depth)

      Description copied from class: `AstNode`
      Emits source code for this node. Callee is responsible for calling this function recursively on children, incrementing indent as appropriate.

      Note: if the parser was in error-recovery mode, some AST nodes may have `null` children that are expected to be non-`null` when no errors are present. In this situation, the behavior of the `toSource` method is undefined: `toSource` implementations may assume that the AST node is error-free, since it is intended to be invoked only at runtime after a successful parse.

      Overrides:
        `toSource` in class `Scope`
      Parameters:
        `depth` - the current recursion depth, typically beginning at 0 when called on the root node.

    - #### debugPrint

          public java.lang.String debugPrint()

      A debug-printer that includes comments (at the end).
      Overrides:
        `debugPrint` in class `AstNode`
      Returns:
        a very verbose indented printout of the tree. The format of each line is: abs-pos name position length [identifier]

    - #### checkParentLinks

          public void checkParentLinks()

      Debugging function to check that the parser has set the parent link for every node in the tree.
      Throws:
        `java.lang.IllegalStateException` - if a parent link is missing