org.htmlunit.corejs.javascript.ast

Class Scope

java.lang.Object

org.htmlunit.corejs.javascript.Node

org.htmlunit.corejs.javascript.ast.AstNode

org.htmlunit.corejs.javascript.ast.Jump

org.htmlunit.corejs.javascript.ast.Scope

All Implemented Interfaces:

Comparable<AstNode>, Iterable<Node>

Direct Known Subclasses:

ArrayComprehension, GeneratorExpression, LetNode, Loop, ScriptNode

public class Scope
extends Jump

Represents a scope in the lexical scope chain. Base type for all AstNode implementations that can introduce a new scope.

Nested Class Summary

Nested classes/interfaces inherited from class org.htmlunit.corejs.javascript.ast.AstNode

AstNode.DebugPrintVisitor, AstNode.PositionComparator

Nested classes/interfaces inherited from class org.htmlunit.corejs.javascript.Node

Node.NodeIterator

Field Summary

Fields

Modifier and Type	Field and Description
protected Scope	parentScope
protected Map<String,Symbol>	symbolTable
protected ScriptNode	top

Fields inherited from class org.htmlunit.corejs.javascript.ast.Jump

target

Fields inherited from class org.htmlunit.corejs.javascript.ast.AstNode

inlineComment, length, parent, position

Fields inherited from class org.htmlunit.corejs.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, DIRECTCALL_PROP, END_DROPS_OFF, END_RETURNS, END_RETURNS_VALUE, END_UNREACHED, END_YIELDS, EXPRESSION_CLOSURE_PROP, first, FIRST_PROP, 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, NUMBER_OF_SPREAD, OBJECT_IDS_PROP, OBJECT_LITERAL_DESTRUCTURING, OPTIONAL_CHAINING, PARENTHESIZED_PROP, POST_FLAG, PROPERTY_FLAG, propListHead, REGEXP_PROP, RIGHT, SKIP_INDEXES_PROP, SPECIALCALL_EVAL, SPECIALCALL_PROP, SPECIALCALL_WITH, SUPER_PROPERTY_ACCESS, TARGETBLOCK_PROP, TEMPLATE_LITERAL_PROP, TRAILING_COMMA, type, VARIABLE_PROP

Constructor Summary

Constructors

Constructor and Description
Scope()
Scope(int pos)
Scope(int pos, int len)

Method Summary

Modifier and Type	Method and Description
void	addChildScope(Scope child) Add a scope to our list of child scopes.
void	clearParentScope() Used only for code generation.
List<Scope>	getChildScopes() Return a list of the scopes whose parent is this scope.
Scope	getDefiningScope(String name) Returns the scope in which this name is defined
Scope	getParentScope()
List<AstNode>	getStatements() Returns a copy of the child list, with each child cast to an AstNode.
Symbol	getSymbol(String name) Looks up a symbol in this scope.
Map<String,Symbol>	getSymbolTable() Returns the symbol table for this scope.
ScriptNode	getTop() Returns current script or function scope
static void	joinScopes(Scope source, Scope dest) Copies all symbols from source scope to dest scope.
void	putSymbol(Symbol symbol) Enters a symbol into this scope.
void	replaceWith(Scope newScope) Used by the parser; not intended for typical use.
void	setParentScope(Scope parentScope) Sets parent scope
void	setSymbolTable(Map<String,Symbol> table) Sets the symbol table for this scope.
void	setTop(ScriptNode top) Sets top current script or function scope
static Scope	splitScope(Scope scope) Creates a new scope node, moving symbol table information from "scope" to the new node, and making "scope" a nested scope contained by the new node.
String	toSource(int depth) Jumps are only used directly during code generation, and do not support this interface.
void	visit(NodeVisitor v) Jumps are only used directly during code generation, and do not support this interface.

Methods inherited from class org.htmlunit.corejs.javascript.ast.Jump

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

Methods inherited from class org.htmlunit.corejs.javascript.ast.AstNode

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

Methods inherited from class org.htmlunit.corejs.javascript.Node

addChildAfter, addChildBefore, addChildrenToBack, addChildrenToFront, addChildToBack, addChildToFront, getBigInt, getChildBefore, getColumn, 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, setBigInt, setDouble, setJsDocNode, setLineColumnNumber, 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

Field Detail

symbolTable

protected Map<String,Symbol> symbolTable

parentScope

protected Scope parentScope

top

protected ScriptNode top

Constructor Detail

Scope

public Scope()

Scope

public Scope(int pos)

Scope

public Scope(int pos,
             int len)

Method Detail

getParentScope

public Scope getParentScope()

setParentScope

public void setParentScope(Scope parentScope)

Sets parent scope

clearParentScope

public void clearParentScope()

Used only for code generation.

getChildScopes

public List<Scope> getChildScopes()

Return a list of the scopes whose parent is this scope.

Returns:

the list of scopes we enclose, or null if none

addChildScope

public void addChildScope(Scope child)

Add a scope to our list of child scopes. Sets the child's parent scope to this scope.

Throws:

IllegalStateException - if the child's parent scope is non-null

replaceWith

public void replaceWith(Scope newScope)

Used by the parser; not intended for typical use. Changes the parent-scope links for this scope's child scopes to the specified new scope. Copies symbols from this scope into new scope.

Parameters:

newScope - the scope that will replace this one on the scope stack.

getTop

public ScriptNode getTop()

Returns current script or function scope

setTop

public void setTop(ScriptNode top)

Sets top current script or function scope

splitScope

public static Scope splitScope(Scope scope)

Creates a new scope node, moving symbol table information from "scope" to the new node, and making "scope" a nested scope contained by the new node. Useful for injecting a new scope in a scope chain.

joinScopes

public static void joinScopes(Scope source,
                              Scope dest)

Copies all symbols from source scope to dest scope.

getDefiningScope

public Scope getDefiningScope(String name)

Returns the scope in which this name is defined

Parameters:

name - the symbol to look up

Returns:

this Scope, one of its parent scopes, or null if the name is not defined any this scope chain

getSymbol

public Symbol getSymbol(String name)

Looks up a symbol in this scope.

Parameters:

name - the symbol name

Returns:

the Symbol, or null if not found

putSymbol

public void putSymbol(Symbol symbol)

Enters a symbol into this scope.

getSymbolTable

public Map<String,Symbol> getSymbolTable()

Returns the symbol table for this scope.

Returns:

the symbol table. May be null.

setSymbolTable

public void setSymbolTable(Map<String,Symbol> table)

Sets the symbol table for this scope. May be null.

getStatements

public List<AstNode> getStatements()

Returns a copy of the child list, with each child cast to an AstNode.

Throws:

ClassCastException - if any non-AstNode objects are in the child list, e.g. if this method is called after the code generator begins the tree transformation.

toSource

public String toSource(int depth)

Description copied from class: Jump

Jumps are only used directly during code generation, and do not support this interface.

Overrides:

toSource in class Jump

Parameters:

depth - the current recursion depth, typically beginning at 0 when called on the root node.

visit

public void visit(NodeVisitor v)

Description copied from class: Jump

Jumps are only used directly during code generation, and do not support this interface.

Overrides:

visit in class Jump

Parameters:

v - the object to call with this node and its children