Module org.htmlunit.corejs

Package org.htmlunit.corejs.javascript

Class JSFunction

java.lang.Object

org.htmlunit.corejs.javascript.SlotMapOwner<Scriptable>

org.htmlunit.corejs.javascript.ScriptableObject

org.htmlunit.corejs.javascript.BaseFunction

org.htmlunit.corejs.javascript.JSFunction

All Implemented Interfaces:

Serializable, Callable, ConstProperties<Scriptable>, Constructable, DebuggableObject, Function, PropHolder<Scriptable>, Scriptable, ScriptOrFn<JSFunction>, SymbolScriptable

public class JSFunction
extends BaseFunction
implements ScriptOrFn<JSFunction>

Represents a JavaScript function built upon a a JSDescriptor. All the immutable metadata associated with the function is stored on the descriptor, with only the lexically bound this, the home object required for super calls, and mutable properties held on the function object itself.

See Also:

• Serialized Form

Nested Class Summary

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

ScriptableObject.DescriptorInfo, ScriptableObject.KeyComparator, ScriptableObject.LambdaGetterFunction, ScriptableObject.LambdaSetterFunction

Field Summary

Fields inherited from class org.htmlunit.corejs.javascript.BaseFunction

Id_arguments, Id_arity, Id_length, Id_name, Id_prototype, MAX_INSTANCE_ID

Fields inherited from class org.htmlunit.corejs.javascript.ScriptableObject

CONST, DONTENUM, EMPTY, LEGACY_CONST, PERMANENT, READONLY, STRICTLY_READONLY, UNINITIALIZED_CONST

Fields inherited from class org.htmlunit.corejs.javascript.SlotMapOwner

isSealed

Fields inherited from interface org.htmlunit.corejs.javascript.Scriptable

NOT_FOUND

Constructor Summary

Constructors

Constructor	Description
JSFunction(Context cx, VarScope scope, JSDescriptor<JSFunction> descriptor, Object lexicalThis, Object lexicalNewTarget, Scriptable homeObject)

Method Summary

Modifier and Type	Method	Description
Object	call(Context cx, Object nt, VarScope scope, Object thisObj, Object[] args)
Scriptable	construct(Context cx, Object nt, VarScope s, Object[] args)	Call the function as a constructor.
static JSFunction	createFunction(Context cx, VarScope scope, JSDescriptor<JSFunction> desc, Scriptable homeObject, Object staticSecurityDomain)	Create function compiled from Function(...) constructor.
protected void	createPrototypeProperty()
static JSScript	createScript(JSDescriptor<JSScript> desc, Scriptable homeObject, Object staticSecurityDomain)	Create script from compiled bytecode.
int	getArity()
DebuggableScript	getDebuggableView()
VarScope	getDeclarationScope()	Return the scope in which this function was declared or closed over.
JSDescriptor<JSFunction>	getDescriptor()
String	getFunctionName()
Object	getFunctionThis(Scriptable functionThis)
Scriptable	getHomeObject()
protected int	getLanguageVersion()
int	getLength()
Object	getLexicalNewTarget()
protected int	getParamAndVarCount()
protected int	getParamCount()
protected boolean	getParamOrVarConst(int index)
protected String	getParamOrVarName(int index)
String	getRawSource()
final Object	getThisObj(Object thisObj)
protected boolean	hasDefaultParameters()
boolean	hasNoFunctionStatementNamed(String name)
protected boolean	hasPrototypeProperty()
boolean	isConstructor()	Return whether this function can be called as a constructor.
protected boolean	isGeneratorFunction()
boolean	isScript()
boolean	isShorthand()
boolean	isStrict()
Object	resumeGenerator(Context cx, VarScope scope, int operation, Object state, Object value)
void	setHomeObject(Scriptable homeObject)
protected void	setPrototypeProperty(Object prototype)

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

call, createObject, createObject, createProperties, createPrototypeProperty, defaultGet, defaultHas, defaultPut, getClassName, getClassPrototype, getPrototypeProperty, getTypeOf, hasInstance, prototypeDescSetter, setImmunePrototypeProperty, setPrototypePropertyAttributes, setStandardPropertyAttributes, setupDefaultPrototype

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

applyDescriptorToAttributeBitset, avoidObjectDetection, buildDataDescriptor, callMethod, callMethod, checkNotSealed, checkPropertyChangeForSlot, checkPropertyChangeForSlot, checkPropertyDefinition, checkPropertyDefinition, checkSlotRemoval, defineBuiltinProperty, defineBuiltinProperty, defineBuiltInProperty, defineClass, defineClass, defineClass, defineConst, defineConstProperty, defineFunctionProperties, defineOwnProperties, defineOwnProperty, defineOwnProperty, defineOwnProperty, defineProperty, defineProperty, defineProperty, defineProperty, defineProperty, defineProperty, defineProperty, defineProperty, defineProperty, defineProperty, delete, delete, delete, deleteProperty, deleteProperty, deleteProperty, ensureScriptable, ensureScriptableObject, ensureScriptableObjectButNotSymbol, ensureSymbolScriptable, ensureType, equivalentValues, get, get, getAllIds, getAncestor, getArrayPrototype, getClassPrototype, getClassPrototype, getDefaultValue, getDefaultValue, getExternalArrayData, getExternalArrayLength, getFunctionPrototype, getGeneratorFunctionPrototype, getGetterOrSetter, getGetterOrSetter, getObjectPrototype, getOwnPropertyDescriptor, getParentScope, getProperty, getProperty, getProperty, getProperty, getProperty, getPropertyIds, getPrototype, getSuperProperty, getSuperProperty, getSuperProperty, getThis, getTopLevelScope, getTopScopeValue, getTypedProperty, getTypedProperty, has, hasProperty, hasProperty, hasProperty, hasProperty, isAccessorDescriptor, isAccessorDescriptor, isConst, isDataDescriptor, isEmpty, isExtensible, isFalse, isGenericDescriptor, isGenericDescriptor, isGetterOrSetter, isGetterOrSetter, isTrue, preventExtensions, put, put, put, putConst, putConstProperty, putConstProperty, putOwnProperty, putOwnProperty, putOwnProperty, putProperty, putProperty, putProperty, putProperty, putSuperProperty, putSuperProperty, putSuperProperty, querySlot, redefineProperty, redefineProperty, sameValue, sealObject, setCommonDescriptorProperties, setExternalArrayData, setGetterOrSetter, setParentScope, setPrototype, size

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

associateValue, checkNotSealed, copyAssociatedValue, createSlotMap, createSlotMap, defineProperty, defineProperty, get, get, getAssociatedValue, getAttributes, getAttributes, getAttributes, getAttributes, getAttributes, getIds, has, has, isSealed, readMaps, setAttributes, setAttributes, setAttributes, setAttributes, setAttributes, writeMaps

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.htmlunit.corejs.javascript.Constructable

construct

Methods inherited from interface org.htmlunit.corejs.javascript.Scriptable

delete, delete, delete, get, get, get, getAncestor, getDefaultValue, getIds, getParentScope, getPrototype, has, has, has, put, put, put, setParentScope, setPrototype

Methods inherited from interface org.htmlunit.corejs.javascript.SymbolScriptable

get, has

Constructor Details

JSFunction

public JSFunction(Context cx,
 VarScope scope,
 JSDescriptor<JSFunction> descriptor,
 Object lexicalThis,
 Object lexicalNewTarget,
 Scriptable homeObject)

Method Details

setPrototypeProperty

protected void setPrototypeProperty(Object prototype)

Overrides:

setPrototypeProperty in class BaseFunction

getDeclarationScope

public VarScope getDeclarationScope()

Description copied from interface: Function

Return the scope in which this function was declared or closed over. This is the "[[Environment]]" defined in https://tc39.es/ecma262/#sec-ecmascript-function-objects. Although this is currently precisely equal to the parent scope (or "__parent__") of an object it is useful to distinguish the two concepts as parent scopes are no longer supported by the spec in general and present a significant barrier to future optimisations.

Specified by:

getDeclarationScope in interface Function

Specified by:

getDeclarationScope in interface ScriptOrFn<JSFunction>

Overrides:

getDeclarationScope in class BaseFunction

getDescriptor

public JSDescriptor<JSFunction> getDescriptor()

Specified by:

getDescriptor in interface ScriptOrFn<JSFunction>

isShorthand

public boolean isShorthand()

isStrict

public boolean isStrict()

getArity

public int getArity()

Overrides:

getArity in class BaseFunction

getDebuggableView

public DebuggableScript getDebuggableView()

getLanguageVersion

protected int getLanguageVersion()

hasPrototypeProperty

protected boolean hasPrototypeProperty()

Overrides:

hasPrototypeProperty in class BaseFunction

isGeneratorFunction

protected boolean isGeneratorFunction()

Overrides:

isGeneratorFunction in class BaseFunction

getLength

public int getLength()

Overrides:

getLength in class BaseFunction

getParamAndVarCount

protected int getParamAndVarCount()

getParamCount

protected int getParamCount()

getParamOrVarConst

protected boolean getParamOrVarConst(int index)

getParamOrVarName

protected String getParamOrVarName(int index)

getRawSource

public String getRawSource()

createPrototypeProperty

protected void createPrototypeProperty()

Overrides:

createPrototypeProperty in class BaseFunction

call

public Object call(Context cx,
 Object nt,
 VarScope scope,
 Object thisObj,
 Object[] args)

Overrides:

call in class BaseFunction

getThisObj

public final Object getThisObj(Object thisObj)

construct

public Scriptable construct(Context cx,
 Object nt,
 VarScope s,
 Object[] args)

Description copied from interface: Function

Call the function as a constructor.

This method is invoked by the runtime in order to satisfy a use of the JavaScript new operator. This method is expected to create a new object and return it.

If nt is equal to this then this call is equivalent `new f(...arguments), but reflection and super constructor calls may pass in different values.

Specified by:

construct in interface Constructable

Specified by:

construct in interface Function

Overrides:

construct in class BaseFunction

Parameters:

cx - the current Context for this thread

nt - the new.target for this call,

s - an enclosing scope of the caller except when the function is called from a closure.

args - the array of arguments

Returns:

the allocated object

isScript

public boolean isScript()

hasDefaultParameters

protected boolean hasDefaultParameters()

Overrides:

hasDefaultParameters in class BaseFunction

hasNoFunctionStatementNamed

public boolean hasNoFunctionStatementNamed(String name)

getFunctionName

public String getFunctionName()

Overrides:

getFunctionName in class BaseFunction

resumeGenerator

public Object resumeGenerator(Context cx,
 VarScope scope,
 int operation,
 Object state,
 Object value)

getHomeObject

public Scriptable getHomeObject()

Specified by:

getHomeObject in interface ScriptOrFn<JSFunction>

Overrides:

getHomeObject in class BaseFunction

getLexicalNewTarget

public Object getLexicalNewTarget()

setHomeObject

public void setHomeObject(Scriptable homeObject)

Overrides:

setHomeObject in class BaseFunction

getFunctionThis

public Object getFunctionThis(Scriptable functionThis)

createScript

public static JSScript createScript(JSDescriptor<JSScript> desc,
 Scriptable homeObject,
 Object staticSecurityDomain)

Create script from compiled bytecode.

createFunction

public static JSFunction createFunction(Context cx,
 VarScope scope,
 JSDescriptor<JSFunction> desc,
 Scriptable homeObject,
 Object staticSecurityDomain)

Create function compiled from Function(...) constructor.

isConstructor

public boolean isConstructor()

Description copied from interface: Function

Return whether this function can be called as a constructor.

Specified by:

isConstructor in interface Function

Overrides:

isConstructor in class BaseFunction