org.htmlunit.corejs.javascript.ast

Class FunctionNode

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

org.htmlunit.corejs.javascript.ast.ScriptNode

org.htmlunit.corejs.javascript.ast.FunctionNode

All Implemented Interfaces:

Comparable<AstNode>, Iterable<Node>

public class FunctionNode
extends ScriptNode

A JavaScript function declaration or expression.

Node type is Token.FUNCTION.

FunctionDeclaration :
        function Identifier ( FormalParameterListopt ) { FunctionBody }
 FunctionExpression :
        function Identifieropt ( FormalParameterListopt ) { FunctionBody }
 FormalParameterList :
        Identifier
        FormalParameterList , Identifier
 FunctionBody :
        SourceElements
 Program :
        SourceElements
 SourceElements :
        SourceElement
        SourceElements SourceElement
 SourceElement :
        Statement
        FunctionDeclaration

JavaScript 1.8 introduces "function closures" of the form

function ([params] ) Expression

In this case the FunctionNode node will have no body but will have an expression.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	FunctionNode.Form

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
static int	ARROW_FUNCTION
static int	FUNCTION_EXPRESSION
static int	FUNCTION_EXPRESSION_STATEMENT
static int	FUNCTION_STATEMENT There are three types of functions that can be defined.

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

parentScope, symbolTable, 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
FunctionNode()
FunctionNode(int pos)
FunctionNode(int pos, Name name)

Method Summary

Modifier and Type	Method and Description
int	addFunction(FunctionNode fnNode) Adds a FunctionNode to the functions table for codegen.
void	addLiveLocals(Node node, int[] locals)
void	addParam(AstNode param) Adds a parameter to the function parameter list.
void	addResumptionPoint(Node target)
AstNode	getBody() Returns function body.
List<Object>	getDefaultParams()
List<Node[]>	getDestructuringRvalues()
Name	getFunctionName() Returns function name
int	getFunctionType() Returns the function type (statement, expr, statement expr)
Map<Node,int[]>	getLiveLocals()
int	getLp() Returns left paren position, -1 if missing
AstNode	getMemberExprNode()
String	getName() Returns the function name as a string
List<AstNode>	getParams() Returns the function parameter list
List<Node>	getResumptionPoints()
int	getRp() Returns right paren position, -1 if missing
boolean	hasRestParameter()
boolean	isES6Generator()
boolean	isExpressionClosure() Returns whether this is a 1.8 function closure
boolean	isGenerator()
boolean	isGetterMethod()
boolean	isMethod()
boolean	isNormalMethod()
boolean	isParam(AstNode node) Returns true if the specified AstNode node is a parameter of this Function node.
boolean	isSetterMethod()
boolean	isShorthand()
void	putDefaultParams(Object left, Object right)
void	putDestructuringRvalues(Node left, Node right)
boolean	requiresActivation() Return true if this function requires an Ecma-262 Activation object.
boolean	requiresArgumentObject()
void	setBody(AstNode body) Sets function body, and sets its parent to this node.
void	setFunctionIsGetterMethod()
void	setFunctionIsNormalMethod()
void	setFunctionIsSetterMethod()
void	setFunctionName(Name name) Sets function name, and sets its parent to this node.
void	setFunctionType(int type)
void	setHasRestParameter(boolean hasRestParameter)
void	setIsES6Generator()
void	setIsExpressionClosure(boolean isExpressionClosure) Sets whether this is a 1.8 function closure
void	setIsGenerator()
void	setIsShorthand()
void	setLp(int lp) Sets left paren position
void	setMemberExprNode(AstNode node) Rhino supports a nonstandard Ecma extension that allows you to say, for instance, function a.b.c(arg1, arg) {...}, and it will be rewritten at codegen time to: a.b.c = function(arg1, arg2) {...}
void	setParams(List<AstNode> params) Sets the function parameter list, and sets the parent for each element of the list.
void	setParens(int lp, int rp) Sets both paren positions
void	setRequiresActivation()
void	setRequiresArgumentObject()
void	setRp(int rp) Sets right paren position
String	toSource(int depth) Jumps are only used directly during code generation, and do not support this interface.
void	visit(NodeVisitor v) Visits this node, the function name node if supplied, the parameters, and the body.

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

addRegExp, addTemplateLiteral, flattenSymbolTable, getBaseLineno, getCompilerData, getEndLineno, getFunctionCount, getFunctionNode, getFunctions, getIndexForNameNode, getNextTempName, getParamAndVarConst, getParamAndVarCount, getParamAndVarNames, getParamCount, getParamOrVarName, getRawSource, getRawSourceEnd, getRawSourceStart, getRegexpCount, getRegexpFlags, getRegexpString, getSourceName, getSymbols, getTemplateLiteralCount, getTemplateLiteralStrings, isInStrictMode, isMethodDefinition, setBaseLineno, setCompilerData, setEndLineno, setInStrictMode, setMethodDefinition, setRawSource, setRawSourceBounds, setRawSourceEnd, setRawSourceStart, setSourceName, setSymbols

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

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

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

FUNCTION_STATEMENT

public static final int FUNCTION_STATEMENT

There are three types of functions that can be defined. The first is a function statement. This is a function appearing as a top-level statement (i.e., not nested inside some other statement) in either a script or a function.

The second is a function expression, which is a function appearing in an expression except for the third type, which is...

The third type is a function expression where the expression is the top-level expression in an expression statement.

The three types of functions have different treatment and must be distinguished.

See Also:

Constant Field Values

FUNCTION_EXPRESSION

public static final int FUNCTION_EXPRESSION

See Also:

Constant Field Values

FUNCTION_EXPRESSION_STATEMENT

public static final int FUNCTION_EXPRESSION_STATEMENT

See Also:

Constant Field Values

ARROW_FUNCTION

public static final int ARROW_FUNCTION

See Also:

Constant Field Values

Constructor Detail

FunctionNode

public FunctionNode()

FunctionNode

public FunctionNode(int pos)

FunctionNode

public FunctionNode(int pos,
                    Name name)

Method Detail

getDefaultParams

public List<Object> getDefaultParams()

Overrides:

getDefaultParams in class ScriptNode

putDefaultParams

public void putDefaultParams(Object left,
                             Object right)

getDestructuringRvalues

public List<Node[]> getDestructuringRvalues()

Overrides:

getDestructuringRvalues in class ScriptNode

putDestructuringRvalues

public void putDestructuringRvalues(Node left,
                                    Node right)

Overrides:

putDestructuringRvalues in class ScriptNode

getFunctionName

public Name getFunctionName()

Returns function name

Returns:

function name, null for anonymous functions

setFunctionName

public void setFunctionName(Name name)

Sets function name, and sets its parent to this node.

Parameters:

name - function name, null for anonymous functions

getName

public String getName()

Returns the function name as a string

Returns:

the function name, "" if anonymous

getParams

public List<AstNode> getParams()

Returns the function parameter list

Returns:

the function parameter list. Returns an immutable empty list if there are no parameters.

setParams

public void setParams(List<AstNode> params)

Sets the function parameter list, and sets the parent for each element of the list.

Parameters:

params - the function parameter list, or null if no params

addParam

public void addParam(AstNode param)

Adds a parameter to the function parameter list. Sets the parent of the param node to this node.

Parameters:

param - the parameter

Throws:

IllegalArgumentException - if param is null

isParam

public boolean isParam(AstNode node)

Returns true if the specified AstNode node is a parameter of this Function node. This provides a way during AST traversal to disambiguate the function name node from the parameter nodes.

getBody

public AstNode getBody()

Returns function body. Normally a Block, but can be a plain AstNode if it's a function closure.

Returns:

the body. Can be null only if the AST is malformed.

setBody

public void setBody(AstNode body)

Sets function body, and sets its parent to this node. Also sets the encoded source bounds based on the body bounds. Assumes the function node absolute position has already been set, and the body node's absolute position and length are set.

Parameters:

body - function body. Its parent is set to this node, and its position is updated to be relative to this node.

Throws:

IllegalArgumentException - if body is null

getLp

public int getLp()

Returns left paren position, -1 if missing

setLp

public void setLp(int lp)

Sets left paren position

getRp

public int getRp()

Returns right paren position, -1 if missing

setRp

public void setRp(int rp)

Sets right paren position

setParens

public void setParens(int lp,
                      int rp)

Sets both paren positions

isExpressionClosure

public boolean isExpressionClosure()

Returns whether this is a 1.8 function closure

setIsExpressionClosure

public void setIsExpressionClosure(boolean isExpressionClosure)

Sets whether this is a 1.8 function closure

requiresActivation

public boolean requiresActivation()

Return true if this function requires an Ecma-262 Activation object. The Activation object is implemented by NativeCall, and is fairly expensive to create, so when possible, the interpreter attempts to use a plain call frame instead.

Returns:

true if this function needs activation. It could be needed if there is a lexical closure, or in a number of other situations.

setRequiresActivation

public void setRequiresActivation()

requiresArgumentObject

public boolean requiresArgumentObject()

setRequiresArgumentObject

public void setRequiresArgumentObject()

isGenerator

public boolean isGenerator()

setIsGenerator

public void setIsGenerator()

isES6Generator

public boolean isES6Generator()

setIsES6Generator

public void setIsES6Generator()

hasRestParameter

public boolean hasRestParameter()

Overrides:

hasRestParameter in class ScriptNode

setHasRestParameter

public void setHasRestParameter(boolean hasRestParameter)

isShorthand

public boolean isShorthand()

Overrides:

isShorthand in class ScriptNode

setIsShorthand

public void setIsShorthand()

addResumptionPoint

public void addResumptionPoint(Node target)

getResumptionPoints

public List<Node> getResumptionPoints()

getLiveLocals

public Map<Node,int[]> getLiveLocals()

addLiveLocals

public void addLiveLocals(Node node,
                          int[] locals)

addFunction

public int addFunction(FunctionNode fnNode)

Description copied from class: ScriptNode

Adds a FunctionNode to the functions table for codegen. Does not set the parent of the node.

Overrides:

addFunction in class ScriptNode

Returns:

the index of the function within its parent

getFunctionType

public int getFunctionType()

Returns the function type (statement, expr, statement expr)

setFunctionType

public void setFunctionType(int type)

isMethod

public boolean isMethod()

isGetterMethod

public boolean isGetterMethod()

isSetterMethod

public boolean isSetterMethod()

isNormalMethod

public boolean isNormalMethod()

setFunctionIsGetterMethod

public void setFunctionIsGetterMethod()

setFunctionIsSetterMethod

public void setFunctionIsSetterMethod()

setFunctionIsNormalMethod

public void setFunctionIsNormalMethod()

setMemberExprNode

public void setMemberExprNode(AstNode node)

Rhino supports a nonstandard Ecma extension that allows you to say, for instance, function a.b.c(arg1, arg) {...}, and it will be rewritten at codegen time to: a.b.c = function(arg1, arg2) {...} If we detect an expression other than a simple Name in the position where a function name was expected, we record that expression here.

This extension is only available by setting the CompilerEnv option "isAllowMemberExprAsFunctionName" in the Parser.

getMemberExprNode

public AstNode getMemberExprNode()

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 Scope

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, the function name node if supplied, the parameters, and the body. If there is a member-expr node, it is visited last.

Overrides:

visit in class ScriptNode

Parameters:

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