org.mozilla.javascript.ast

## Class ExpressionStatement

- java.lang.Object
- - org.mozilla.javascript.Node
  - - org.mozilla.javascript.ast.AstNode
    - - org.mozilla.javascript.ast.ExpressionStatement

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

      public class ExpressionStatement
      extends AstNode

  AST node representing an expression in a statement context. The node type is `Token.EXPR_VOID` if inside a function, or else `Token.EXPR_RESULT` if inside a script.

- - ### 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.AstNode

      `length, parent, position`

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

      `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
    `ExpressionStatement()`
    `ExpressionStatement(AstNode expr)` Constructs a new `ExpressionStatement` wrapping the specified expression.
    `ExpressionStatement(AstNode expr, boolean hasResult)` Constructs a new `ExpressionStatement` wrapping the specified expression.
    `ExpressionStatement(int pos, int len)`
    `ExpressionStatement(int pos, int len, AstNode expr)` Constructs a new `ExpressionStatement`

  - ### Method Summary

    Methods
    Modifier and Type | Method and Description
    --- | ---
    `AstNode` | `getExpression()` Returns the wrapped expression
    `boolean` | `hasSideEffects()` Returns true if this node has side effects
    `void` | `setExpression(AstNode expression)` Sets the wrapped expression, and sets its parent to this node.
    `void` | `setHasResult()` Called by the parser to set node type to EXPR_RESULT if this node is not within a Function.
    `java.lang.String` | `toSource(int depth)` Emits source code for this node.
    `void` | `visit(NodeVisitor v)` Visits this node, then the wrapped statement.

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

      `addChild, assertNotNull, codeBug, compareTo, debugPrint, depth, getAbsolutePosition, getAstRoot, getEnclosingFunction, getEnclosingScope, getLength, getLineno, getParent, getPosition, 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`

- - ### Constructor Detail

    - #### ExpressionStatement

          public ExpressionStatement()

    - #### ExpressionStatement

          public ExpressionStatement(AstNode expr,
                             boolean hasResult)

      Constructs a new `ExpressionStatement` wrapping the specified expression. Sets this node's position to the position of the wrapped node, and sets the wrapped node's position to zero. Sets this node's length to the length of the wrapped node.
      Parameters:
        `expr` - the wrapped expression
        `hasResult` - `true` if this expression has side effects. If true, sets node type to EXPR_RESULT, else to EXPR_VOID.

    - #### ExpressionStatement

          public ExpressionStatement(AstNode expr)

      Constructs a new `ExpressionStatement` wrapping the specified expression. Sets this node's position to the position of the wrapped node, and sets the wrapped node's position to zero. Sets this node's length to the length of the wrapped node.
      Parameters:
        `expr` - the wrapped expression

    - #### ExpressionStatement

          public ExpressionStatement(int pos,
                             int len)

    - #### ExpressionStatement

          public ExpressionStatement(int pos,
                             int len,
                             AstNode expr)

      Constructs a new `ExpressionStatement`
      Parameters:
        `expr` - the wrapped `AstNode`. The `ExpressionStatement`'s bounds are set to those of expr, and expr's parent is set to this node.
      Throws:
        `java.lang.IllegalArgumentException` - if `expr` is null

  - ### Method Detail

    - #### setHasResult

          public void setHasResult()

      Called by the parser to set node type to EXPR_RESULT if this node is not within a Function.

    - #### getExpression

          public AstNode getExpression()

      Returns the wrapped expression

    - #### setExpression

          public void setExpression(AstNode expression)

      Sets the wrapped expression, and sets its parent to this node.
      Throws:
        `IllegalArgumentException}` - if expression is `null`

    - #### hasSideEffects

          public boolean hasSideEffects()

      Returns true if this node has side effects
      Overrides:
        `hasSideEffects` in class `AstNode`
      Throws:
        `java.lang.IllegalStateException` - if expression has not yet been set.

    - #### 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.

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

    - #### visit

          public void visit(NodeVisitor v)

      Visits this node, then the wrapped statement.
      Specified by:
        `visit` in class `AstNode`
      Parameters:
        `v` - the object to call with this node and its children