org.mozilla.javascript.ScriptableObject Maven / Gradle / Ivy
Show all versions of rhino-runtime Show documentation
/* -*- Mode: java; tab-width: 8; indent-tabs-mode: nil; c-basic-offset: 4 -*-
*
* This Source Code Form is subject to the terms of the Mozilla Public
* License, v. 2.0. If a copy of the MPL was not distributed with this
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
// API class
package org.mozilla.javascript;
import java.io.IOException;
import java.io.ObjectInputStream;
import java.io.ObjectOutputStream;
import java.io.Serializable;
import java.lang.annotation.Annotation;
import java.lang.reflect.AccessibleObject;
import java.lang.reflect.Constructor;
import java.lang.reflect.InvocationTargetException;
import java.lang.reflect.Member;
import java.lang.reflect.Method;
import java.lang.reflect.Modifier;
import java.util.Arrays;
import java.util.Comparator;
import java.util.HashMap;
import java.util.HashSet;
import java.util.Map;
import java.util.function.Consumer;
import java.util.function.Supplier;
import org.mozilla.javascript.ScriptRuntime.StringIdOrIndex;
import org.mozilla.javascript.annotations.JSConstructor;
import org.mozilla.javascript.annotations.JSFunction;
import org.mozilla.javascript.annotations.JSGetter;
import org.mozilla.javascript.annotations.JSSetter;
import org.mozilla.javascript.annotations.JSStaticFunction;
import org.mozilla.javascript.debug.DebuggableObject;
/**
* This is the default implementation of the Scriptable interface. This class provides convenient
* default behavior that makes it easier to define host objects.
*
* Various properties and methods of JavaScript objects can be conveniently defined using methods
* of ScriptableObject.
*
*
Classes extending ScriptableObject must define the getClassName method.
*
* @see org.mozilla.javascript.Scriptable
* @author Norris Boyd
*/
public abstract class ScriptableObject
implements Scriptable, SymbolScriptable, Serializable, DebuggableObject, ConstProperties {
private static final long serialVersionUID = 2829861078851942586L;
/**
* The empty property attribute.
*
*
Used by getAttributes() and setAttributes().
*
* @see org.mozilla.javascript.ScriptableObject#getAttributes(String)
* @see org.mozilla.javascript.ScriptableObject#setAttributes(String, int)
*/
public static final int EMPTY = 0x00;
/**
* Property attribute indicating assignment to this property is ignored.
*
* @see org.mozilla.javascript.ScriptableObject #put(String, Scriptable, Object)
* @see org.mozilla.javascript.ScriptableObject#getAttributes(String)
* @see org.mozilla.javascript.ScriptableObject#setAttributes(String, int)
*/
public static final int READONLY = 0x01;
/**
* Property attribute indicating property is not enumerated.
*
*
Only enumerated properties will be returned by getIds().
*
* @see org.mozilla.javascript.ScriptableObject#getIds()
* @see org.mozilla.javascript.ScriptableObject#getAttributes(String)
* @see org.mozilla.javascript.ScriptableObject#setAttributes(String, int)
*/
public static final int DONTENUM = 0x02;
/**
* Property attribute indicating property cannot be deleted.
*
* @see org.mozilla.javascript.ScriptableObject#delete(String)
* @see org.mozilla.javascript.ScriptableObject#getAttributes(String)
* @see org.mozilla.javascript.ScriptableObject#setAttributes(String, int)
*/
public static final int PERMANENT = 0x04;
/**
* Property attribute indicating that this is a const property that has not been assigned yet.
* The first 'const' assignment to the property will clear this bit.
*/
public static final int UNINITIALIZED_CONST = 0x08;
public static final int CONST = PERMANENT | READONLY | UNINITIALIZED_CONST;
/** The prototype of this object. */
private Scriptable prototypeObject;
/** The parent scope of this object. */
private Scriptable parentScopeObject;
/**
* This holds all the slots. It may or may not be thread-safe, and may expand itself to a
* different data structure depending on the size of the object.
*/
private transient SlotMapContainer slotMap;
// Where external array data is stored.
private transient ExternalArrayData externalData;
private volatile Map associatedValues;
private boolean isExtensible = true;
private boolean isSealed = false;
private static final Method GET_ARRAY_LENGTH;
static {
try {
GET_ARRAY_LENGTH = ScriptableObject.class.getMethod("getExternalArrayLength");
} catch (NoSuchMethodException nsm) {
throw new RuntimeException(nsm);
}
}
protected static ScriptableObject buildDataDescriptor(
Scriptable scope, Object value, int attributes) {
ScriptableObject desc = new NativeObject();
ScriptRuntime.setBuiltinProtoAndParent(desc, scope, TopLevel.Builtins.Object);
desc.defineProperty("value", value, EMPTY);
desc.setCommonDescriptorProperties(attributes, true);
return desc;
}
protected void setCommonDescriptorProperties(int attributes, boolean defineWritable) {
if (defineWritable) {
defineProperty("writable", (attributes & READONLY) == 0, EMPTY);
}
defineProperty("enumerable", (attributes & DONTENUM) == 0, EMPTY);
defineProperty("configurable", (attributes & PERMANENT) == 0, EMPTY);
}
static void checkValidAttributes(int attributes) {
final int mask = READONLY | DONTENUM | PERMANENT | UNINITIALIZED_CONST;
if ((attributes & ~mask) != 0) {
throw new IllegalArgumentException(String.valueOf(attributes));
}
}
private static SlotMapContainer createSlotMap(int initialSize) {
Context cx = Context.getCurrentContext();
if ((cx != null) && cx.hasFeature(Context.FEATURE_THREAD_SAFE_OBJECTS)) {
return new ThreadSafeSlotMapContainer(initialSize);
}
return new SlotMapContainer(initialSize);
}
public ScriptableObject() {
slotMap = createSlotMap(0);
}
public ScriptableObject(Scriptable scope, Scriptable prototype) {
if (scope == null) throw new IllegalArgumentException();
parentScopeObject = scope;
prototypeObject = prototype;
slotMap = createSlotMap(0);
}
/**
* Gets the value that will be returned by calling the typeof operator on this object.
*
* @return default is "object" unless {@link #avoidObjectDetection()} is true in
* which case it returns "undefined"
*/
public String getTypeOf() {
return avoidObjectDetection() ? "undefined" : "object";
}
/**
* Return the name of the class.
*
* This is typically the same name as the constructor. Classes extending ScriptableObject
* must implement this abstract method.
*/
@Override
public abstract String getClassName();
/**
* Returns true if the named property is defined.
*
* @param name the name of the property
* @param start the object in which the lookup began
* @return true if and only if the property was found in the object
*/
@Override
public boolean has(String name, Scriptable start) {
return null != slotMap.query(name, 0);
}
/**
* Returns true if the property index is defined.
*
* @param index the numeric index for the property
* @param start the object in which the lookup began
* @return true if and only if the property was found in the object
*/
@Override
public boolean has(int index, Scriptable start) {
if (externalData != null) {
return (index < externalData.getArrayLength());
}
return null != slotMap.query(null, index);
}
/** A version of "has" that supports symbols. */
@Override
public boolean has(Symbol key, Scriptable start) {
return null != slotMap.query(key, 0);
}
/**
* Returns the value of the named property or NOT_FOUND.
*
*
If the property was created using defineProperty, the appropriate getter method is called.
*
* @param name the name of the property
* @param start the object in which the lookup began
* @return the value of the property (may be null), or NOT_FOUND
*/
@Override
public Object get(String name, Scriptable start) {
Slot slot = slotMap.query(name, 0);
if (slot == null) {
return Scriptable.NOT_FOUND;
}
return slot.getValue(start);
}
/**
* Returns the value of the indexed property or NOT_FOUND.
*
* @param index the numeric index for the property
* @param start the object in which the lookup began
* @return the value of the property (may be null), or NOT_FOUND
*/
@Override
public Object get(int index, Scriptable start) {
if (externalData != null) {
if (index < externalData.getArrayLength()) {
return externalData.getArrayElement(index);
}
return Scriptable.NOT_FOUND;
}
Slot slot = slotMap.query(null, index);
if (slot == null) {
return Scriptable.NOT_FOUND;
}
return slot.getValue(start);
}
/** Another version of Get that supports Symbol keyed properties. */
@Override
public Object get(Symbol key, Scriptable start) {
Slot slot = slotMap.query(key, 0);
if (slot == null) {
return Scriptable.NOT_FOUND;
}
return slot.getValue(start);
}
/**
* Sets the value of the named property, creating it if need be.
*
*
If the property was created using defineProperty, the appropriate setter method is called.
*
*
If the property's attributes include READONLY, no action is taken. This method will
* actually set the property in the start object.
*
* @param name the name of the property
* @param start the object whose property is being set
* @param value value to set the property to
*/
@Override
public void put(String name, Scriptable start, Object value) {
if (putImpl(name, 0, start, value)) return;
if (start == this) throw Kit.codeBug();
start.put(name, start, value);
}
/**
* Sets the value of the indexed property, creating it if need be.
*
* @param index the numeric index for the property
* @param start the object whose property is being set
* @param value value to set the property to
*/
@Override
public void put(int index, Scriptable start, Object value) {
if (externalData != null) {
if (index < externalData.getArrayLength()) {
externalData.setArrayElement(index, value);
} else {
throw new JavaScriptException(
ScriptRuntime.newNativeError(
Context.getCurrentContext(),
this,
TopLevel.NativeErrors.RangeError,
new Object[] {"External array index out of bounds "}),
null,
0);
}
return;
}
if (putImpl(null, index, start, value)) return;
if (start == this) throw Kit.codeBug();
start.put(index, start, value);
}
/** Implementation of put required by SymbolScriptable objects. */
@Override
public void put(Symbol key, Scriptable start, Object value) {
if (putImpl(key, 0, start, value)) return;
if (start == this) throw Kit.codeBug();
ensureSymbolScriptable(start).put(key, start, value);
}
/**
* Removes a named property from the object.
*
*
If the property is not found, or it has the PERMANENT attribute, no action is taken.
*
* @param name the name of the property
*/
@Override
public void delete(String name) {
checkNotSealed(name, 0);
slotMap.remove(name, 0);
}
/**
* Removes the indexed property from the object.
*
*
If the property is not found, or it has the PERMANENT attribute, no action is taken.
*
* @param index the numeric index for the property
*/
@Override
public void delete(int index) {
checkNotSealed(null, index);
slotMap.remove(null, index);
}
/** Removes an object like the others, but using a Symbol as the key. */
@Override
public void delete(Symbol key) {
checkNotSealed(key, 0);
slotMap.remove(key, 0);
}
/**
* Sets the value of the named const property, creating it if need be.
*
*
If the property was created using defineProperty, the appropriate setter method is called.
*
*
If the property's attributes include READONLY, no action is taken. This method will
* actually set the property in the start object.
*
* @param name the name of the property
* @param start the object whose property is being set
* @param value value to set the property to
*/
@Override
public void putConst(String name, Scriptable start, Object value) {
if (putConstImpl(name, 0, start, value, READONLY)) return;
if (start == this) throw Kit.codeBug();
if (start instanceof ConstProperties)
((ConstProperties) start).putConst(name, start, value);
else start.put(name, start, value);
}
@Override
public void defineConst(String name, Scriptable start) {
if (putConstImpl(name, 0, start, Undefined.instance, UNINITIALIZED_CONST)) return;
if (start == this) throw Kit.codeBug();
if (start instanceof ConstProperties) ((ConstProperties) start).defineConst(name, start);
}
/**
* Returns true if the named property is defined as a const on this object.
*
* @param name
* @return true if the named property is defined as a const, false otherwise.
*/
@Override
public boolean isConst(String name) {
Slot slot = slotMap.query(name, 0);
if (slot == null) {
return false;
}
return (slot.getAttributes() & (PERMANENT | READONLY)) == (PERMANENT | READONLY);
}
/**
* @deprecated Use {@link #getAttributes(String name)}. The engine always ignored the start
* argument.
*/
@Deprecated
public final int getAttributes(String name, Scriptable start) {
return getAttributes(name);
}
/**
* @deprecated Use {@link #getAttributes(int index)}. The engine always ignored the start
* argument.
*/
@Deprecated
public final int getAttributes(int index, Scriptable start) {
return getAttributes(index);
}
/**
* @deprecated Use {@link #setAttributes(String name, int attributes)}. The engine always
* ignored the start argument.
*/
@Deprecated
public final void setAttributes(String name, Scriptable start, int attributes) {
setAttributes(name, attributes);
}
/**
* @deprecated Use {@link #setAttributes(int index, int attributes)}. The engine always ignored
* the start argument.
*/
@Deprecated
public void setAttributes(int index, Scriptable start, int attributes) {
setAttributes(index, attributes);
}
/**
* Get the attributes of a named property.
*
*
The property is specified by name as defined for has.
*
*
*
* @param name the identifier for the property
* @return the bitset of attributes
* @exception EvaluatorException if the named property is not found
* @see org.mozilla.javascript.ScriptableObject#has(String, Scriptable)
* @see org.mozilla.javascript.ScriptableObject#READONLY
* @see org.mozilla.javascript.ScriptableObject#DONTENUM
* @see org.mozilla.javascript.ScriptableObject#PERMANENT
* @see org.mozilla.javascript.ScriptableObject#EMPTY
*/
public int getAttributes(String name) {
return getAttributeSlot(name, 0).getAttributes();
}
/**
* Get the attributes of an indexed property.
*
* @param index the numeric index for the property
* @exception EvaluatorException if the named property is not found is not found
* @return the bitset of attributes
* @see org.mozilla.javascript.ScriptableObject#has(String, Scriptable)
* @see org.mozilla.javascript.ScriptableObject#READONLY
* @see org.mozilla.javascript.ScriptableObject#DONTENUM
* @see org.mozilla.javascript.ScriptableObject#PERMANENT
* @see org.mozilla.javascript.ScriptableObject#EMPTY
*/
public int getAttributes(int index) {
return getAttributeSlot(null, index).getAttributes();
}
public int getAttributes(Symbol sym) {
return getAttributeSlot(sym).getAttributes();
}
/**
* Set the attributes of a named property.
*
*
The property is specified by name as defined for has.
*
*
The possible attributes are READONLY, DONTENUM, and PERMANENT. Combinations of attributes
* are expressed by the bitwise OR of attributes. EMPTY is the state of no attributes set. Any
* unused bits are reserved for future use.
*
* @param name the name of the property
* @param attributes the bitset of attributes
* @exception EvaluatorException if the named property is not found
* @see org.mozilla.javascript.Scriptable#has(String, Scriptable)
* @see org.mozilla.javascript.ScriptableObject#READONLY
* @see org.mozilla.javascript.ScriptableObject#DONTENUM
* @see org.mozilla.javascript.ScriptableObject#PERMANENT
* @see org.mozilla.javascript.ScriptableObject#EMPTY
*/
public void setAttributes(String name, int attributes) {
checkNotSealed(name, 0);
Slot attrSlot = slotMap.modify(name, 0, 0);
attrSlot.setAttributes(attributes);
}
/**
* Set the attributes of an indexed property.
*
* @param index the numeric index for the property
* @param attributes the bitset of attributes
* @exception EvaluatorException if the named property is not found
* @see org.mozilla.javascript.Scriptable#has(String, Scriptable)
* @see org.mozilla.javascript.ScriptableObject#READONLY
* @see org.mozilla.javascript.ScriptableObject#DONTENUM
* @see org.mozilla.javascript.ScriptableObject#PERMANENT
* @see org.mozilla.javascript.ScriptableObject#EMPTY
*/
public void setAttributes(int index, int attributes) {
checkNotSealed(null, index);
Slot attrSlot = slotMap.modify(null, index, 0);
attrSlot.setAttributes(attributes);
}
/** Set attributes of a Symbol-keyed property. */
public void setAttributes(Symbol key, int attributes) {
checkNotSealed(key, 0);
Slot attrSlot = slotMap.modify(key, 0, 0);
attrSlot.setAttributes(attributes);
}
/** Implement the legacy "__defineGetter__" and "__defineSetter__" methods. */
public void setGetterOrSetter(
String name, int index, Callable getterOrSetter, boolean isSetter) {
if (name != null && index != 0) throw new IllegalArgumentException(name);
checkNotSealed(name, index);
AccessorSlot aSlot;
if (isExtensible()) {
Slot slot = slotMap.modify(name, index, 0);
if (slot instanceof AccessorSlot) {
aSlot = (AccessorSlot) slot;
} else {
aSlot = new AccessorSlot(slot);
slotMap.replace(slot, aSlot);
}
} else {
Slot slot = slotMap.query(name, index);
if (slot instanceof AccessorSlot) {
aSlot = (AccessorSlot) slot;
} else {
return;
}
}
int attributes = aSlot.getAttributes();
if ((attributes & READONLY) != 0) {
throw Context.reportRuntimeErrorById("msg.modify.readonly", name);
}
// Emulate old behavior where nothing happened if it wasn't actually a Function
if (isSetter) {
if (getterOrSetter instanceof Function) {
aSlot.setter = new AccessorSlot.FunctionSetter(getterOrSetter);
} else {
aSlot.setter = null;
}
} else {
if (getterOrSetter instanceof Function) {
aSlot.getter = new AccessorSlot.FunctionGetter(getterOrSetter);
} else {
aSlot.getter = null;
}
}
aSlot.value = Undefined.instance;
}
/**
* Get the getter or setter for a given property. Used by __lookupGetter__ and __lookupSetter__.
*
* @param name Name of the object. If nonnull, index must be 0.
* @param index Index of the object. If nonzero, name must be null.
* @param scope the current scope.
* @param isSetter If true, return the setter, otherwise return the getter.
* @exception IllegalArgumentException if both name and index are nonnull and nonzero
* respectively.
* @return Undefined.instance if the property does not exist. Otherwise returns either the
* getter or the setter for the property, depending on the value of isSetter (may be
* undefined if unset).
*/
public Object getGetterOrSetter(String name, int index, Scriptable scope, boolean isSetter) {
if (name != null && index != 0) throw new IllegalArgumentException(name);
Slot slot = slotMap.query(name, index);
if (slot == null) return null;
Function getterOrSetter =
isSetter
? slot.getSetterFunction(name, scope)
: slot.getGetterFunction(name, scope);
return (getterOrSetter == null) ? Undefined.instance : getterOrSetter;
}
/**
* Get the getter or setter for a given property. Used by __lookupGetter__ and __lookupSetter__.
*
* @deprecated since 1.7.14. Use the form with the scope to ensure consistent function prototype
* handling in all cases.
* @param name Name of the object. If nonnull, index must be 0.
* @param index Index of the object. If nonzero, name must be null.
* @param isSetter If true, return the setter, otherwise return the getter.
* @exception IllegalArgumentException if both name and index are nonnull and nonzero
* respectively.
* @return Null if the property does not exist. Otherwise returns either the getter or the
* setter for the property, depending on the value of isSetter (may be undefined if unset).
*/
@Deprecated
public Object getGetterOrSetter(String name, int index, boolean isSetter) {
return getGetterOrSetter(name, index, this, isSetter);
}
/**
* Returns whether a property is a getter or a setter
*
* @param name property name
* @param index property index
* @param setter true to check for a setter, false for a getter
* @return whether the property is a getter or a setter
*/
protected boolean isGetterOrSetter(String name, int index, boolean setter) {
Slot slot = slotMap.query(name, index);
return (slot != null && slot.isSetterSlot());
}
void addLazilyInitializedValue(String name, int index, LazilyLoadedCtor init, int attributes) {
if (name != null && index != 0) throw new IllegalArgumentException(name);
checkNotSealed(name, index);
Slot slot = slotMap.modify(name, index, 0);
LazyLoadSlot lslot;
if (slot instanceof LazyLoadSlot) {
lslot = (LazyLoadSlot) slot;
} else {
lslot = new LazyLoadSlot(slot);
slotMap.replace(slot, lslot);
}
lslot.setAttributes(attributes);
lslot.value = init;
}
/**
* Attach the specified object to this object, and delegate all indexed property lookups to it.
* In other words, if the object has 3 elements, then an attempt to look up or modify "[0]",
* "[1]", or "[2]" will be delegated to this object. Additional indexed properties outside the
* range specified, and additional non-indexed properties, may still be added. The object
* specified must implement the ExternalArrayData interface.
*
* @param array the List to use for delegated property access. Set this to null to revert back
* to regular property access.
* @since 1.7.6
*/
public void setExternalArrayData(ExternalArrayData array) {
externalData = array;
if (array == null) {
delete("length");
} else {
// Define "length" to return whatever length the List gives us.
defineProperty("length", null, GET_ARRAY_LENGTH, null, READONLY | DONTENUM);
}
}
/**
* Return the array that was previously set by the call to "setExternalArrayData".
*
* @return the array, or null if it was never set
* @since 1.7.6
*/
public ExternalArrayData getExternalArrayData() {
return externalData;
}
/**
* This is a function used by setExternalArrayData to dynamically get the "length" property
* value.
*/
public Object getExternalArrayLength() {
return Integer.valueOf(externalData == null ? 0 : externalData.getArrayLength());
}
/** Returns the prototype of the object. */
@Override
public Scriptable getPrototype() {
return prototypeObject;
}
/** Sets the prototype of the object. */
@Override
public void setPrototype(Scriptable m) {
prototypeObject = m;
}
/** Returns the parent (enclosing) scope of the object. */
@Override
public Scriptable getParentScope() {
return parentScopeObject;
}
/** Sets the parent (enclosing) scope of the object. */
@Override
public void setParentScope(Scriptable m) {
parentScopeObject = m;
}
/**
* Returns an array of ids for the properties of the object.
*
*
Any properties with the attribute DONTENUM are not listed.
*
*
*
* @return an array of java.lang.Objects with an entry for every listed property. Properties
* accessed via an integer index will have a corresponding Integer entry in the returned
* array. Properties accessed by a String will have a String entry in the returned array.
*/
@Override
public Object[] getIds() {
return getIds(false, false);
}
/**
* Returns an array of ids of all non-Symbol properties of the object.
*
*
All non-Symbol properties, even those with attribute DONTENUM, are listed.
*
* @return an array of java.lang.Objects with an entry for every non-Symbol property. Properties
* accessed via an integer index will have a corresponding Integer entry in the returned
* array. Properties accessed by a String will have a String entry in the returned array.
*/
@Override
public Object[] getAllIds() {
return getIds(true, false);
}
/**
* Implements the [[DefaultValue]] internal method.
*
*
Note that the toPrimitive conversion is a no-op for every type other than Object, for
* which [[DefaultValue]] is called. See ECMA 9.1.
*
*
A hint of null means "no hint".
*
* @param typeHint the type hint
* @return the default value for the object
*
See ECMA 8.6.2.6.
*/
@Override
public Object getDefaultValue(Class typeHint) {
return getDefaultValue(this, typeHint);
}
public static Object getDefaultValue(Scriptable object, Class typeHint) {
Context cx = null;
for (int i = 0; i < 2; i++) {
boolean tryToString;
if (typeHint == ScriptRuntime.StringClass) {
tryToString = (i == 0);
} else {
tryToString = (i == 1);
}
String methodName;
if (tryToString) {
methodName = "toString";
} else {
methodName = "valueOf";
}
Object v = getProperty(object, methodName);
if (!(v instanceof Function)) continue;
Function fun = (Function) v;
if (cx == null) {
cx = Context.getContext();
}
v = fun.call(cx, fun.getParentScope(), object, ScriptRuntime.emptyArgs);
if (v != null) {
if (!(v instanceof Scriptable)) {
return v;
}
if (typeHint == ScriptRuntime.ScriptableClass
|| typeHint == ScriptRuntime.FunctionClass) {
return v;
}
if (tryToString && v instanceof Wrapper) {
// Let a wrapped java.lang.String pass for a primitive
// string.
Object u = ((Wrapper) v).unwrap();
if (u instanceof String) return u;
}
}
}
// fall through to error
String arg = (typeHint == null) ? "undefined" : typeHint.getName();
throw ScriptRuntime.typeErrorById("msg.default.value", arg);
}
/**
* Implements the instanceof operator.
*
*
This operator has been proposed to ECMA.
*
* @param instance The value that appeared on the LHS of the instanceof operator
* @return true if "this" appears in value's prototype chain
*/
@Override
public boolean hasInstance(Scriptable instance) {
// Default for JS objects (other than Function) is to do prototype
// chasing. This will be overridden in NativeFunction and non-JS
// objects.
return ScriptRuntime.jsDelegatesTo(instance, this);
}
/**
* Emulate the SpiderMonkey (and Firefox) feature of allowing custom objects to avoid detection
* by normal "object detection" code patterns. This is used to implement document.all. See
* https://bugzilla.mozilla.org/show_bug.cgi?id=412247. This is an analog to JOF_DETECTING from
* SpiderMonkey; see https://bugzilla.mozilla.org/show_bug.cgi?id=248549. Other than this
* special case, embeddings should return false.
*
* @return true if this object should avoid object detection
* @since 1.7R1
*/
public boolean avoidObjectDetection() {
return false;
}
/**
* Custom == operator. Must return {@link Scriptable#NOT_FOUND} if this object does
* not have custom equality operator for the given value, Boolean.TRUE if this
* object is equivalent to value, Boolean.FALSE if this object is not
* equivalent to value.
*
*
The default implementation returns Boolean.TRUE if this == value or {@link
* Scriptable#NOT_FOUND} otherwise. It indicates that by default custom equality is available
* only if value is this in which case true is returned.
*/
protected Object equivalentValues(Object value) {
return (this == value) ? Boolean.TRUE : Scriptable.NOT_FOUND;
}
/**
* Defines JavaScript objects from a Java class that implements Scriptable.
*
*
If the given class has a method
*
*
* static void init(Context cx, Scriptable scope, boolean sealed);
*
* or its compatibility form
*
*
* static void init(Scriptable scope);
*
* then it is invoked and no further initialization is done.
*
* However, if no such a method is found, then the class's constructors and methods are used
* to initialize a class in the following manner.
*
*
First, the zero-parameter constructor of the class is called to create the prototype. If
* no such constructor exists, a {@link EvaluatorException} is thrown.
*
*
Next, all methods are scanned for special prefixes that indicate that they have special
* meaning for defining JavaScript objects. These special prefixes are
*
*
* jsFunction_ for a JavaScript function
* jsStaticFunction_ for a JavaScript function that is a property of the
* constructor
* jsGet_ for a getter of a JavaScript property
* jsSet_ for a setter of a JavaScript property
* jsConstructor for a JavaScript function that is the constructor
*
*
* If the method's name begins with "jsFunction_", a JavaScript function is created with a
* name formed from the rest of the Java method name following "jsFunction_". So a Java method
* named "jsFunction_foo" will define a JavaScript method "foo". Calling this JavaScript
* function will cause the Java method to be called. The parameters of the method must be of
* number and types as defined by the FunctionObject class. The JavaScript function is then
* added as a property of the prototype.
*
*
If the method's name begins with "jsStaticFunction_", it is handled similarly except that
* the resulting JavaScript function is added as a property of the constructor object. The Java
* method must be static.
*
*
If the method's name begins with "jsGet_" or "jsSet_", the method is considered to define
* a property. Accesses to the defined property will result in calls to these getter and setter
* methods. If no setter is defined, the property is defined as READONLY.
*
*
If the method's name is "jsConstructor", the method is considered to define the body of
* the constructor. Only one method of this name may be defined. You may use the varargs forms
* for constructors documented in {@link FunctionObject#FunctionObject(String, Member,
* Scriptable)}
*
*
If no method is found that can serve as constructor, a Java constructor will be selected
* to serve as the JavaScript constructor in the following manner. If the class has only one
* Java constructor, that constructor is used to define the JavaScript constructor. If the the
* class has two constructors, one must be the zero-argument constructor (otherwise an {@link
* EvaluatorException} would have already been thrown when the prototype was to be created). In
* this case the Java constructor with one or more parameters will be used to define the
* JavaScript constructor. If the class has three or more constructors, an {@link
* EvaluatorException} will be thrown.
*
*
Finally, if there is a method
*
*
* static void finishInit(Scriptable scope, FunctionObject constructor,
* Scriptable prototype)
*
* it will be called to finish any initialization. The scope argument will be
* passed, along with the newly created constructor and the newly created prototype.
*
*
*
* @param scope The scope in which to define the constructor.
* @param clazz The Java class to use to define the JavaScript objects and properties.
* @exception IllegalAccessException if access is not available to a reflected class member
* @exception InstantiationException if unable to instantiate the named class
* @exception InvocationTargetException if an exception is thrown during execution of methods of
* the named class
* @see org.mozilla.javascript.Function
* @see org.mozilla.javascript.FunctionObject
* @see org.mozilla.javascript.ScriptableObject#READONLY
* @see org.mozilla.javascript.ScriptableObject #defineProperty(String, Class, int)
*/
public static void defineClass(Scriptable scope, Class clazz)
throws IllegalAccessException, InstantiationException, InvocationTargetException {
defineClass(scope, clazz, false, false);
}
/**
* Defines JavaScript objects from a Java class, optionally allowing sealing.
*
* Similar to defineClass(Scriptable scope, Class clazz) except that sealing is
* allowed. An object that is sealed cannot have properties added or removed. Note that sealing
* is not allowed in the current ECMA/ISO language specification, but is likely for the next
* version.
*
* @param scope The scope in which to define the constructor.
* @param clazz The Java class to use to define the JavaScript objects and properties. The class
* must implement Scriptable.
* @param sealed Whether or not to create sealed standard objects that cannot be modified.
* @exception IllegalAccessException if access is not available to a reflected class member
* @exception InstantiationException if unable to instantiate the named class
* @exception InvocationTargetException if an exception is thrown during execution of methods of
* the named class
* @since 1.4R3
*/
public static void defineClass(
Scriptable scope, Class clazz, boolean sealed)
throws IllegalAccessException, InstantiationException, InvocationTargetException {
defineClass(scope, clazz, sealed, false);
}
/**
* Defines JavaScript objects from a Java class, optionally allowing sealing and mapping of Java
* inheritance to JavaScript prototype-based inheritance.
*
* Similar to defineClass(Scriptable scope, Class clazz) except that sealing and
* inheritance mapping are allowed. An object that is sealed cannot have properties added or
* removed. Note that sealing is not allowed in the current ECMA/ISO language specification, but
* is likely for the next version.
*
* @param scope The scope in which to define the constructor.
* @param clazz The Java class to use to define the JavaScript objects and properties. The class
* must implement Scriptable.
* @param sealed Whether or not to create sealed standard objects that cannot be modified.
* @param mapInheritance Whether or not to map Java inheritance to JavaScript prototype-based
* inheritance.
* @return the class name for the prototype of the specified class
* @exception IllegalAccessException if access is not available to a reflected class member
* @exception InstantiationException if unable to instantiate the named class
* @exception InvocationTargetException if an exception is thrown during execution of methods of
* the named class
* @since 1.6R2
*/
public static String defineClass(
Scriptable scope, Class clazz, boolean sealed, boolean mapInheritance)
throws IllegalAccessException, InstantiationException, InvocationTargetException {
BaseFunction ctor = buildClassCtor(scope, clazz, sealed, mapInheritance);
if (ctor == null) return null;
String name = ctor.getClassPrototype().getClassName();
defineProperty(scope, name, ctor, ScriptableObject.DONTENUM);
return name;
}
static BaseFunction buildClassCtor(
Scriptable scope, Class clazz, boolean sealed, boolean mapInheritance)
throws IllegalAccessException, InstantiationException, InvocationTargetException {
Method[] methods = FunctionObject.getMethodList(clazz);
for (Method method : methods) {
if (!method.getName().equals("init")) continue;
Class[] parmTypes = method.getParameterTypes();
if (parmTypes.length == 3
&& parmTypes[0] == ScriptRuntime.ContextClass
&& parmTypes[1] == ScriptRuntime.ScriptableClass
&& parmTypes[2] == Boolean.TYPE
&& Modifier.isStatic(method.getModifiers())) {
Object[] args = {
Context.getContext(), scope, sealed ? Boolean.TRUE : Boolean.FALSE
};
method.invoke(null, args);
return null;
}
if (parmTypes.length == 1
&& parmTypes[0] == ScriptRuntime.ScriptableClass
&& Modifier.isStatic(method.getModifiers())) {
Object[] args = {scope};
method.invoke(null, args);
return null;
}
}
// If we got here, there isn't an "init" method with the right
// parameter types.
Constructor[] ctors = clazz.getConstructors();
Constructor protoCtor = null;
for (Constructor constructor : ctors) {
if (constructor.getParameterTypes().length == 0) {
protoCtor = constructor;
break;
}
}
if (protoCtor == null) {
throw Context.reportRuntimeErrorById("msg.zero.arg.ctor", clazz.getName());
}
Scriptable proto = (Scriptable) protoCtor.newInstance(ScriptRuntime.emptyArgs);
String className = proto.getClassName();
// check for possible redefinition
Object existing = getProperty(getTopLevelScope(scope), className);
if (existing instanceof BaseFunction) {
Object existingProto = ((BaseFunction) existing).getPrototypeProperty();
if (existingProto != null && clazz.equals(existingProto.getClass())) {
return (BaseFunction) existing;
}
}
// Set the prototype's prototype, trying to map Java inheritance to JS
// prototype-based inheritance if requested to do so.
Scriptable superProto = null;
if (mapInheritance) {
Class superClass = clazz.getSuperclass();
if (ScriptRuntime.ScriptableClass.isAssignableFrom(superClass)
&& !Modifier.isAbstract(superClass.getModifiers())) {
Class superScriptable = extendsScriptable(superClass);
String name =
ScriptableObject.defineClass(
scope, superScriptable, sealed, mapInheritance);
if (name != null) {
superProto = ScriptableObject.getClassPrototype(scope, name);
}
}
}
if (superProto == null) {
superProto = ScriptableObject.getObjectPrototype(scope);
}
proto.setPrototype(superProto);
// Find out whether there are any methods that begin with
// "js". If so, then only methods that begin with special
// prefixes will be defined as JavaScript entities.
final String functionPrefix = "jsFunction_";
final String staticFunctionPrefix = "jsStaticFunction_";
final String getterPrefix = "jsGet_";
final String setterPrefix = "jsSet_";
final String ctorName = "jsConstructor";
Member ctorMember = findAnnotatedMember(methods, JSConstructor.class);
if (ctorMember == null) {
ctorMember = findAnnotatedMember(ctors, JSConstructor.class);
}
if (ctorMember == null) {
ctorMember = FunctionObject.findSingleMethod(methods, ctorName);
}
if (ctorMember == null) {
if (ctors.length == 1) {
ctorMember = ctors[0];
} else if (ctors.length == 2) {
if (ctors[0].getParameterTypes().length == 0) ctorMember = ctors[1];
else if (ctors[1].getParameterTypes().length == 0) ctorMember = ctors[0];
}
if (ctorMember == null) {
throw Context.reportRuntimeErrorById("msg.ctor.multiple.parms", clazz.getName());
}
}
FunctionObject ctor = new FunctionObject(className, ctorMember, scope);
if (ctor.isVarArgsMethod()) {
throw Context.reportRuntimeErrorById("msg.varargs.ctor", ctorMember.getName());
}
ctor.initAsConstructor(
scope,
proto,
ScriptableObject.DONTENUM | ScriptableObject.PERMANENT | ScriptableObject.READONLY);
Method finishInit = null;
HashSet staticNames = new HashSet<>(), instanceNames = new HashSet<>();
for (Method method : methods) {
if (method == ctorMember) {
continue;
}
String name = method.getName();
if (name.equals("finishInit")) {
Class[] parmTypes = method.getParameterTypes();
if (parmTypes.length == 3
&& parmTypes[0] == ScriptRuntime.ScriptableClass
&& parmTypes[1] == FunctionObject.class
&& parmTypes[2] == ScriptRuntime.ScriptableClass
&& Modifier.isStatic(method.getModifiers())) {
finishInit = method;
continue;
}
}
// ignore any compiler generated methods.
if (name.indexOf('$') != -1) continue;
if (name.equals(ctorName)) continue;
Annotation annotation = null;
String prefix = null;
if (method.isAnnotationPresent(JSFunction.class)) {
annotation = method.getAnnotation(JSFunction.class);
} else if (method.isAnnotationPresent(JSStaticFunction.class)) {
annotation = method.getAnnotation(JSStaticFunction.class);
} else if (method.isAnnotationPresent(JSGetter.class)) {
annotation = method.getAnnotation(JSGetter.class);
} else if (method.isAnnotationPresent(JSSetter.class)) {
continue;
}
if (annotation == null) {
if (name.startsWith(functionPrefix)) {
prefix = functionPrefix;
} else if (name.startsWith(staticFunctionPrefix)) {
prefix = staticFunctionPrefix;
} else if (name.startsWith(getterPrefix)) {
prefix = getterPrefix;
} else {
// note that setterPrefix is among the unhandled names here -
// we deal with that when we see the getter
continue;
}
}
boolean isStatic =
annotation instanceof JSStaticFunction || prefix == staticFunctionPrefix;
HashSet names = isStatic ? staticNames : instanceNames;
String propName = getPropertyName(name, prefix, annotation);
if (names.contains(propName)) {
throw Context.reportRuntimeErrorById("duplicate.defineClass.name", name, propName);
}
names.add(propName);
name = propName;
if (annotation instanceof JSGetter || prefix == getterPrefix) {
if (!(proto instanceof ScriptableObject)) {
throw Context.reportRuntimeErrorById(
"msg.extend.scriptable", proto.getClass().toString(), name);
}
Method setter = findSetterMethod(methods, name, setterPrefix);
int attr =
ScriptableObject.PERMANENT
| ScriptableObject.DONTENUM
| (setter != null ? 0 : ScriptableObject.READONLY);
((ScriptableObject) proto).defineProperty(name, null, method, setter, attr);
continue;
}
if (isStatic && !Modifier.isStatic(method.getModifiers())) {
throw Context.reportRuntimeError(
"jsStaticFunction must be used with static method.");
}
FunctionObject f = new FunctionObject(name, method, proto);
if (f.isVarArgsConstructor()) {
throw Context.reportRuntimeErrorById("msg.varargs.fun", ctorMember.getName());
}
defineProperty(isStatic ? ctor : proto, name, f, DONTENUM);
if (sealed) {
f.sealObject();
}
}
// Call user code to complete initialization if necessary.
if (finishInit != null) {
Object[] finishArgs = {scope, ctor, proto};
finishInit.invoke(null, finishArgs);
}
// Seal the object if necessary.
if (sealed) {
ctor.sealObject();
if (proto instanceof ScriptableObject) {
((ScriptableObject) proto).sealObject();
}
}
return ctor;
}
private static Member findAnnotatedMember(
AccessibleObject[] members, Class annotation) {
for (AccessibleObject member : members) {
if (member.isAnnotationPresent(annotation)) {
return (Member) member;
}
}
return null;
}
private static Method findSetterMethod(Method[] methods, String name, String prefix) {
String newStyleName = "set" + Character.toUpperCase(name.charAt(0)) + name.substring(1);
for (Method method : methods) {
JSSetter annotation = method.getAnnotation(JSSetter.class);
if (annotation != null) {
if (name.equals(annotation.value())
|| ("".equals(annotation.value())
&& newStyleName.equals(method.getName()))) {
return method;
}
}
}
String oldStyleName = prefix + name;
for (Method method : methods) {
if (oldStyleName.equals(method.getName())) {
return method;
}
}
return null;
}
private static String getPropertyName(String methodName, String prefix, Annotation annotation) {
if (prefix != null) {
return methodName.substring(prefix.length());
}
String propName = null;
if (annotation instanceof JSGetter) {
propName = ((JSGetter) annotation).value();
if (propName == null || propName.length() == 0) {
if (methodName.length() > 3 && methodName.startsWith("get")) {
propName = methodName.substring(3);
if (Character.isUpperCase(propName.charAt(0))) {
if (propName.length() == 1) {
propName = propName.toLowerCase();
} else if (!Character.isUpperCase(propName.charAt(1))) {
propName =
Character.toLowerCase(propName.charAt(0))
+ propName.substring(1);
}
}
}
}
} else if (annotation instanceof JSFunction) {
propName = ((JSFunction) annotation).value();
} else if (annotation instanceof JSStaticFunction) {
propName = ((JSStaticFunction) annotation).value();
}
if (propName == null || propName.length() == 0) {
propName = methodName;
}
return propName;
}
@SuppressWarnings({"unchecked"})
private static Class extendsScriptable(Class c) {
if (ScriptRuntime.ScriptableClass.isAssignableFrom(c)) return (Class) c;
return null;
}
/**
* Define a JavaScript property.
*
* Creates the property with an initial value and sets its attributes.
*
* @param propertyName the name of the property to define.
* @param value the initial value of the property
* @param attributes the attributes of the JavaScript property
* @see org.mozilla.javascript.Scriptable#put(String, Scriptable, Object)
*/
public void defineProperty(String propertyName, Object value, int attributes) {
checkNotSealed(propertyName, 0);
put(propertyName, this, value);
setAttributes(propertyName, attributes);
}
/**
* A version of defineProperty that uses a Symbol key.
*
* @param key symbol of the property to define.
* @param value the initial value of the property
* @param attributes the attributes of the JavaScript property
*/
public void defineProperty(Symbol key, Object value, int attributes) {
checkNotSealed(key, 0);
put(key, this, value);
setAttributes(key, attributes);
}
/**
* Utility method to add properties to arbitrary Scriptable object. If destination is instance
* of ScriptableObject, calls defineProperty there, otherwise calls put in destination ignoring
* attributes
*
* @param destination ScriptableObject to define the property on
* @param propertyName the name of the property to define.
* @param value the initial value of the property
* @param attributes the attributes of the JavaScript property
*/
public static void defineProperty(
Scriptable destination, String propertyName, Object value, int attributes) {
if (!(destination instanceof ScriptableObject)) {
destination.put(propertyName, destination, value);
return;
}
ScriptableObject so = (ScriptableObject) destination;
so.defineProperty(propertyName, value, attributes);
}
/** Utility method to add lambda properties to arbitrary Scriptable object. */
protected void defineProperty(
Scriptable scope,
String name,
int length,
Callable target,
int attributes,
int propertyAttributes) {
LambdaFunction f = new LambdaFunction(scope, name, length, target);
f.setStandardPropertyAttributes(propertyAttributes);
defineProperty(name, f, attributes);
}
/**
* Utility method to add properties to arbitrary Scriptable object. If destination is instance
* of ScriptableObject, calls defineProperty there, otherwise calls put in destination ignoring
* attributes
*
* @param destination ScriptableObject to define the property on
* @param propertyName the name of the property to define.
*/
public static void defineConstProperty(Scriptable destination, String propertyName) {
if (destination instanceof ConstProperties) {
ConstProperties cp = (ConstProperties) destination;
cp.defineConst(propertyName, destination);
} else defineProperty(destination, propertyName, Undefined.instance, CONST);
}
/**
* Define a JavaScript property with getter and setter side effects.
*
*
If the setter is not found, the attribute READONLY is added to the given attributes.
*
*
The getter must be a method with zero parameters, and the setter, if found, must be a
* method with one parameter.
*
*
*
* @param propertyName the name of the property to define. This name also affects the name of
* the setter and getter to search for. If the propertyId is "foo", then clazz
* will be searched for "getFoo" and "setFoo" methods.
* @param clazz the Java class to search for the getter and setter
* @param attributes the attributes of the JavaScript property
* @see org.mozilla.javascript.Scriptable#put(String, Scriptable, Object)
*/
public void defineProperty(String propertyName, Class clazz, int attributes) {
int length = propertyName.length();
if (length == 0) throw new IllegalArgumentException();
char[] buf = new char[3 + length];
propertyName.getChars(0, length, buf, 3);
buf[3] = Character.toUpperCase(buf[3]);
buf[0] = 'g';
buf[1] = 'e';
buf[2] = 't';
String getterName = new String(buf);
buf[0] = 's';
String setterName = new String(buf);
Method[] methods = FunctionObject.getMethodList(clazz);
Method getter = FunctionObject.findSingleMethod(methods, getterName);
Method setter = FunctionObject.findSingleMethod(methods, setterName);
if (setter == null) attributes |= ScriptableObject.READONLY;
defineProperty(propertyName, null, getter, setter == null ? null : setter, attributes);
}
/**
* Define a JavaScript property.
*
*
Use this method only if you wish to define getters and setters for a given property in a
* ScriptableObject. To create a property without special getter or setter side effects, use
* defineProperty(String,int).
*
*
If setter is null, the attribute READONLY is added to the given attributes.
*
*
Several forms of getters or setters are allowed. In all cases the type of the value
* parameter can be any one of the following types: Object, String, boolean, Scriptable, byte,
* short, int, long, float, or double. The runtime will perform appropriate conversions based
* upon the type of the parameter (see description in FunctionObject). The first forms are
* nonstatic methods of the class referred to by 'this':
*
*
* Object getFoo();
* void setFoo(SomeType value);
*
* Next are static methods that may be of any class; the object whose property is being accessed
* is passed in as an extra argument:
*
*
* static Object getFoo(Scriptable obj);
* static void setFoo(Scriptable obj, SomeType value);
*
* Finally, it is possible to delegate to another object entirely using the delegateTo
* parameter. In this case the methods are nonstatic methods of the class delegated to,
* and the object whose property is being accessed is passed in as an extra argument:
*
*
* Object getFoo(Scriptable obj);
* void setFoo(Scriptable obj, SomeType value);
*
* @param propertyName the name of the property to define.
* @param delegateTo an object to call the getter and setter methods on, or null, depending on
* the form used above.
* @param getter the method to invoke to get the value of the property
* @param setter the method to invoke to set the value of the property
* @param attributes the attributes of the JavaScript property
*/
public void defineProperty(
String propertyName, Object delegateTo, Method getter, Method setter, int attributes) {
MemberBox getterBox = null;
if (getter != null) {
getterBox = new MemberBox(getter);
boolean delegatedForm;
if (!Modifier.isStatic(getter.getModifiers())) {
delegatedForm = (delegateTo != null);
getterBox.delegateTo = delegateTo;
} else {
delegatedForm = true;
// Ignore delegateTo for static getter but store
// non-null delegateTo indicator.
getterBox.delegateTo = Void.TYPE;
}
String errorId = null;
Class[] parmTypes = getter.getParameterTypes();
if (parmTypes.length == 0) {
if (delegatedForm) {
errorId = "msg.obj.getter.parms";
}
} else if (parmTypes.length == 1) {
Object argType = parmTypes[0];
// Allow ScriptableObject for compatibility
if (!(argType == ScriptRuntime.ScriptableClass
|| argType == ScriptRuntime.ScriptableObjectClass)) {
errorId = "msg.bad.getter.parms";
} else if (!delegatedForm) {
errorId = "msg.bad.getter.parms";
}
} else {
errorId = "msg.bad.getter.parms";
}
if (errorId != null) {
throw Context.reportRuntimeErrorById(errorId, getter.toString());
}
}
MemberBox setterBox = null;
if (setter != null) {
if (setter.getReturnType() != Void.TYPE)
throw Context.reportRuntimeErrorById("msg.setter.return", setter.toString());
setterBox = new MemberBox(setter);
boolean delegatedForm;
if (!Modifier.isStatic(setter.getModifiers())) {
delegatedForm = (delegateTo != null);
setterBox.delegateTo = delegateTo;
} else {
delegatedForm = true;
// Ignore delegateTo for static setter but store
// non-null delegateTo indicator.
setterBox.delegateTo = Void.TYPE;
}
String errorId = null;
Class[] parmTypes = setter.getParameterTypes();
if (parmTypes.length == 1) {
if (delegatedForm) {
errorId = "msg.setter2.expected";
}
} else if (parmTypes.length == 2) {
Object argType = parmTypes[0];
// Allow ScriptableObject for compatibility
if (!(argType == ScriptRuntime.ScriptableClass
|| argType == ScriptRuntime.ScriptableObjectClass)) {
errorId = "msg.setter2.parms";
} else if (!delegatedForm) {
errorId = "msg.setter1.parms";
}
} else {
errorId = "msg.setter.parms";
}
if (errorId != null) {
throw Context.reportRuntimeErrorById(errorId, setter.toString());
}
}
Slot slot = slotMap.modify(propertyName, 0, 0);
AccessorSlot aSlot;
if (slot instanceof AccessorSlot) {
aSlot = (AccessorSlot) slot;
} else {
aSlot = new AccessorSlot(slot);
slotMap.replace(slot, aSlot);
}
aSlot.setAttributes(attributes);
if (getterBox != null) {
aSlot.getter = new AccessorSlot.MemberBoxGetter(getterBox);
}
if (setterBox != null) {
aSlot.setter = new AccessorSlot.MemberBoxSetter(setterBox);
}
}
/**
* Defines one or more properties on this object.
*
* @param cx the current Context
* @param props a map of property ids to property descriptors
*/
public void defineOwnProperties(Context cx, ScriptableObject props) {
Object[] ids = props.getIds(false, true);
ScriptableObject[] descs = new ScriptableObject[ids.length];
for (int i = 0, len = ids.length; i < len; ++i) {
Object descObj = ScriptRuntime.getObjectElem(props, ids[i], cx);
ScriptableObject desc = ensureScriptableObject(descObj);
checkPropertyDefinition(desc);
descs[i] = desc;
}
for (int i = 0, len = ids.length; i < len; ++i) {
defineOwnProperty(cx, ids[i], descs[i]);
}
}
/**
* Defines a property on an object.
*
* @param cx the current Context
* @param id the name/index of the property
* @param desc the new property descriptor, as described in 8.6.1
*/
public void defineOwnProperty(Context cx, Object id, ScriptableObject desc) {
checkPropertyDefinition(desc);
defineOwnProperty(cx, id, desc, true);
}
/**
* Defines a property on an object.
*
* Based on [[DefineOwnProperty]] from 8.12.10 of the spec.
*
* @param cx the current Context
* @param id the name/index of the property
* @param desc the new property descriptor, as described in 8.6.1
* @param checkValid whether to perform validity checks
*/
protected void defineOwnProperty(
Context cx, Object id, ScriptableObject desc, boolean checkValid) {
Object key = null;
int index = 0;
if (id instanceof Symbol) {
key = id;
} else {
StringIdOrIndex s = ScriptRuntime.toStringIdOrIndex(id);
if (s.stringId == null) {
index = s.index;
} else {
key = s.stringId;
}
}
Slot slot = slotMap.query(key, index);
boolean isNew = slot == null;
if (checkValid) {
ScriptableObject current = slot == null ? null : slot.getPropertyDescriptor(cx, this);
checkPropertyChange(id, current, desc);
}
boolean isAccessor = isAccessorDescriptor(desc);
final int attributes;
if (slot == null) {
slot = slotMap.modify(key, index, 0);
attributes = applyDescriptorToAttributeBitset(DONTENUM | READONLY | PERMANENT, desc);
} else {
attributes = applyDescriptorToAttributeBitset(slot.getAttributes(), desc);
}
if (isAccessor) {
AccessorSlot fslot;
if (slot instanceof AccessorSlot) {
fslot = (AccessorSlot) slot;
} else {
fslot = new AccessorSlot(slot);
slotMap.replace(slot, fslot);
}
Object getter = getProperty(desc, "get");
if (getter != NOT_FOUND) {
fslot.getter = new AccessorSlot.FunctionGetter(getter);
}
Object setter = getProperty(desc, "set");
if (setter != NOT_FOUND) {
fslot.setter = new AccessorSlot.FunctionSetter(setter);
}
fslot.value = Undefined.instance;
fslot.setAttributes(attributes);
} else {
if (!slot.isValueSlot() && isDataDescriptor(desc)) {
Slot newSlot = new Slot(slot);
slotMap.replace(slot, newSlot);
slot = newSlot;
}
Object value = getProperty(desc, "value");
if (value != NOT_FOUND) {
slot.value = value;
} else if (isNew) {
slot.value = Undefined.instance;
}
slot.setAttributes(attributes);
}
}
/**
* Define a property on this object that is implemented using lambda functions. If a property
* with the same name already exists, then it will be replaced. This property will appear to the
* JavaScript user exactly like any other property -- unlike Function properties and those based
* on reflection, the property descriptor will only reflect the value as defined by this
* function.
*
* @param name the name of the function
* @param getter a function that returns the value of the property. If null, then the previous
* version of the value will be returned.
* @param setter a function that sets the value of the property. If null, then the value will be
* set directly and may not be retrieved by the getter.
* @param attributes the attributes to set on the property
*/
public void defineProperty(
String name, Supplier