com.oracle.truffle.js.runtime.objects

Class JSDynamicObject

java.lang.Object

com.oracle.truffle.api.object.DynamicObject

com.oracle.truffle.js.runtime.objects.JSDynamicObject

All Implemented Interfaces:

com.oracle.truffle.api.interop.TruffleObject

Direct Known Subclasses:

JSObject, Nullish

public abstract class JSDynamicObject
extends com.oracle.truffle.api.object.DynamicObject
implements com.oracle.truffle.api.interop.TruffleObject

The common base class for all JavaScript objects as well as null and undefined.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	JSDynamicObject.IsIdenticalOrUndefined

Nested classes/interfaces inherited from class com.oracle.truffle.api.object.DynamicObject

com.oracle.truffle.api.object.DynamicObject.DynamicField

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	JSDynamicObject(com.oracle.truffle.api.object.Shape shape)

Method Summary

Modifier and Type	Method and Description
com.oracle.truffle.api.strings.TruffleString	defaultToString() Follows 19.1.3.6 Object.prototype.toString(), basically: "[object " + [[Symbol.toStringTag]] + "]" or typically "[object Object]" (for non built-in types) if [[Symbol.toStringTag]] is not present.
abstract boolean	defineOwnProperty(Object key, PropertyDescriptor value, boolean doThrow) 9.1.6 [[DefineOwnProperty]] (P, Desc).
abstract boolean	delete(long propIdx, boolean isStrict)
abstract boolean	delete(Object key, boolean isStrict) 9.1.10 [[Delete]] (P).
com.oracle.truffle.api.strings.TruffleString	getBuiltinToStringTag() Returns builtinTag from step 14 of ES6+ 19.1.3.6.
abstract com.oracle.truffle.api.strings.TruffleString	getClassName() The [[Class]] internal property.
static Object	getDynamicType(JSDynamicObject obj)
abstract Object	getHelper(Object receiver, long index, com.oracle.truffle.api.nodes.Node encapsulatingNode)
abstract Object	getHelper(Object receiver, Object key, com.oracle.truffle.api.nodes.Node encapsulatingNode)
static int	getIntOrDefault(JSDynamicObject obj, Object key, int defaultValue)
JSClass	getJSClass()
static JSClass	getJSClass(JSDynamicObject obj)
JSContext	getJSContext()
static JSContext	getJSContext(JSDynamicObject obj)
static JSSharedData	getJSSharedData(JSDynamicObject obj)
static Object[]	getKeyArray(JSDynamicObject obj)
abstract Object	getMethodHelper(Object receiver, Object key, com.oracle.truffle.api.nodes.Node encapsulatingNode)
static int	getObjectFlags(JSDynamicObject obj)
static Object	getOrDefault(JSDynamicObject obj, Object key, Object defaultValue)
static Object	getOrNull(JSDynamicObject obj, Object key)
abstract Object	getOwnHelper(Object receiver, long index, com.oracle.truffle.api.nodes.Node encapsulatingNode)
abstract Object	getOwnHelper(Object receiver, Object key, com.oracle.truffle.api.nodes.Node encapsulatingNode)
abstract PropertyDescriptor	getOwnProperty(Object propertyKey) 9.1.5 [[GetOwnProperty]] (P).
abstract List<Object>	getOwnPropertyKeys(boolean strings, boolean symbols) GetOwnPropertyKeys (O, type).
static com.oracle.truffle.api.object.Property	getProperty(JSDynamicObject obj, Object key)
static com.oracle.truffle.api.object.Property[]	getPropertyArray(JSDynamicObject obj)
static int	getPropertyFlags(JSDynamicObject obj, Object key)
abstract JSDynamicObject	getPrototypeOf() 9.1.1 [[GetPrototypeOf]] ().
Object	getValue(long index)
Object	getValue(Object key) 9.1.8 [[Get]] (P, Receiver).
abstract boolean	hasOnlyShapeProperties() If true, JSDynamicObject.ownPropertyKeys() and JSShape.getProperties(com.oracle.truffle.api.object.Shape) enumerate the same keys.
abstract boolean	hasOwnProperty(long index)
abstract boolean	hasOwnProperty(Object propName)
static boolean	hasProperty(JSDynamicObject obj, Object key)
abstract boolean	hasProperty(long index)
abstract boolean	hasProperty(Object key) 9.1.7 [[HasProperty]] (P).
int	identityHashCode()
abstract boolean	isExtensible() 9.1.3 [[IsExtensible]] ().
static boolean	isJSDynamicObject(Object object) Returns whether object is a JSDynamicObject (JSObject or null/undefined).
List<Object>	ownPropertyKeys() 9.1.12 [[OwnPropertyKeys]]().
abstract boolean	preventExtensions(boolean doThrow) 9.1.4 [[PreventExtensions]] ().
static boolean	removeKey(JSDynamicObject obj, Object key)
abstract boolean	set(long index, Object value, Object receiver, boolean isStrict, com.oracle.truffle.api.nodes.Node encapsulatingNode)
abstract boolean	set(Object key, Object value, Object receiver, boolean isStrict, com.oracle.truffle.api.nodes.Node encapsulatingNode) 9.1.9 [[Set]] (P, V, Receiver).
boolean	setIntegrityLevel(boolean freeze, boolean doThrow) ES2015 7.3.14 SetIntegrityLevel(O, level).
static void	setJSClass(JSDynamicObject obj, JSClass jsclass)
static void	setObjectFlags(JSDynamicObject obj, int flags)
static void	setPropertyFlags(JSDynamicObject obj, Object key, int flags)
abstract boolean	setPrototypeOf(JSDynamicObject newPrototype) 9.1.2 [[SetPrototypeOf]] (V).
boolean	testIntegrityLevel(boolean frozen) ES2015 7.3.15 TestIntegrityLevel(O, level).
static boolean	testProperties(JSDynamicObject obj, Predicate<com.oracle.truffle.api.object.Property> predicate)
abstract com.oracle.truffle.api.strings.TruffleString	toDisplayStringImpl(boolean allowSideEffects, ToDisplayStringFormat format, int depth) A more informative toString variant, mainly used for error messages.
static boolean	updatePropertyFlags(JSDynamicObject obj, Object key, IntUnaryOperator updateFunction) Update property flags, changing the object's shape if need be.

Methods inherited from class com.oracle.truffle.api.object.DynamicObject

clone, getShape

Methods inherited from class java.lang.Object

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

Constructor Detail

JSDynamicObject

protected JSDynamicObject(com.oracle.truffle.api.object.Shape shape)

Method Detail

identityHashCode

public final int identityHashCode()

getJSContext

public final JSContext getJSContext()

getJSClass

public JSClass getJSClass()

getPrototypeOf

public abstract JSDynamicObject getPrototypeOf()

9.1.1 [[GetPrototypeOf]] ().

setPrototypeOf

public abstract boolean setPrototypeOf(JSDynamicObject newPrototype)

9.1.2 [[SetPrototypeOf]] (V).

isExtensible

public abstract boolean isExtensible()

9.1.3 [[IsExtensible]] ().

preventExtensions

public abstract boolean preventExtensions(boolean doThrow)

9.1.4 [[PreventExtensions]] ().

getOwnProperty

public abstract PropertyDescriptor getOwnProperty(Object propertyKey)

9.1.5 [[GetOwnProperty]] (P).

defineOwnProperty

public abstract boolean defineOwnProperty(Object key,
                                          PropertyDescriptor value,
                                          boolean doThrow)

9.1.6 [[DefineOwnProperty]] (P, Desc).

hasProperty

public abstract boolean hasProperty(Object key)

9.1.7 [[HasProperty]] (P).

hasProperty

public abstract boolean hasProperty(long index)

hasOwnProperty

public abstract boolean hasOwnProperty(Object propName)

hasOwnProperty

public abstract boolean hasOwnProperty(long index)

getValue

public Object getValue(Object key)

9.1.8 [[Get]] (P, Receiver). TODO: rename to get once JSDynamicObject#get(Object) is removed.

getValue

public Object getValue(long index)

getHelper

public abstract Object getHelper(Object receiver,
                                 Object key,
                                 com.oracle.truffle.api.nodes.Node encapsulatingNode)

getHelper

public abstract Object getHelper(Object receiver,
                                 long index,
                                 com.oracle.truffle.api.nodes.Node encapsulatingNode)

getOwnHelper

public abstract Object getOwnHelper(Object receiver,
                                    Object key,
                                    com.oracle.truffle.api.nodes.Node encapsulatingNode)

getOwnHelper

public abstract Object getOwnHelper(Object receiver,
                                    long index,
                                    com.oracle.truffle.api.nodes.Node encapsulatingNode)

getMethodHelper

public abstract Object getMethodHelper(Object receiver,
                                       Object key,
                                       com.oracle.truffle.api.nodes.Node encapsulatingNode)

set

public abstract boolean set(Object key,
                            Object value,
                            Object receiver,
                            boolean isStrict,
                            com.oracle.truffle.api.nodes.Node encapsulatingNode)

9.1.9 [[Set]] (P, V, Receiver).

set

public abstract boolean set(long index,
                            Object value,
                            Object receiver,
                            boolean isStrict,
                            com.oracle.truffle.api.nodes.Node encapsulatingNode)

delete

public abstract boolean delete(Object key,
                               boolean isStrict)

9.1.10 [[Delete]] (P).

delete

public abstract boolean delete(long propIdx,
                               boolean isStrict)

ownPropertyKeys

public List<Object> ownPropertyKeys()

9.1.12 [[OwnPropertyKeys]](). Provides all own properties of this object with a String or Symbol key. Represents the [[OwnPropertyKeys]] internal method.

Returns:

a List of the keys of all own properties of that object

getOwnPropertyKeys

public abstract List<Object> getOwnPropertyKeys(boolean strings,
                                                boolean symbols)

GetOwnPropertyKeys (O, type).

Returns:

a List of the keys of all own properties of that object with the specified types

hasOnlyShapeProperties

public abstract boolean hasOnlyShapeProperties()

If true, JSDynamicObject.ownPropertyKeys() and JSShape.getProperties(com.oracle.truffle.api.object.Shape) enumerate the same keys.

getClassName

public abstract com.oracle.truffle.api.strings.TruffleString getClassName()

The [[Class]] internal property. For ES5, this is the second part of what Object.prototype.toString.call(myObj) returns, e.g. "[object Array]".

defaultToString

public com.oracle.truffle.api.strings.TruffleString defaultToString()

Follows 19.1.3.6 Object.prototype.toString(), basically: "[object " + [[Symbol.toStringTag]] + "]" or typically "[object Object]" (for non built-in types) if [[Symbol.toStringTag]] is not present.

For ES5, if follows 15.2.4.2 Object.prototype.toString(), basically: "[object " + [[Class]] + "]".

See Also:

JSDynamicObject.getBuiltinToStringTag()

getBuiltinToStringTag

public com.oracle.truffle.api.strings.TruffleString getBuiltinToStringTag()

Returns builtinTag from step 14 of ES6+ 19.1.3.6. By default returns "Object".

Returns:

"Object" by default

See Also:

JSDynamicObject.defaultToString()

toDisplayStringImpl

public abstract com.oracle.truffle.api.strings.TruffleString toDisplayStringImpl(boolean allowSideEffects,
                                                                                 ToDisplayStringFormat format,
                                                                                 int depth)

A more informative toString variant, mainly used for error messages.

Parameters:

format - formatting parameters

depth - current nesting depth

testIntegrityLevel

public boolean testIntegrityLevel(boolean frozen)

ES2015 7.3.15 TestIntegrityLevel(O, level).

setIntegrityLevel

public boolean setIntegrityLevel(boolean freeze,
                                 boolean doThrow)

ES2015 7.3.14 SetIntegrityLevel(O, level).

isJSDynamicObject

public static boolean isJSDynamicObject(Object object)

Returns whether object is a JSDynamicObject (JSObject or null/undefined).

getJSContext

public static JSContext getJSContext(JSDynamicObject obj)

getJSClass

public static JSClass getJSClass(JSDynamicObject obj)

setJSClass

public static void setJSClass(JSDynamicObject obj,
                              JSClass jsclass)

getDynamicType

public static Object getDynamicType(JSDynamicObject obj)

hasProperty

public static boolean hasProperty(JSDynamicObject obj,
                                  Object key)

getProperty

public static com.oracle.truffle.api.object.Property getProperty(JSDynamicObject obj,
                                                                 Object key)

getKeyArray

public static Object[] getKeyArray(JSDynamicObject obj)

getPropertyArray

public static com.oracle.truffle.api.object.Property[] getPropertyArray(JSDynamicObject obj)

getOrNull

public static Object getOrNull(JSDynamicObject obj,
                               Object key)

getOrDefault

public static Object getOrDefault(JSDynamicObject obj,
                                  Object key,
                                  Object defaultValue)

getIntOrDefault

public static int getIntOrDefault(JSDynamicObject obj,
                                  Object key,
                                  int defaultValue)

getObjectFlags

public static int getObjectFlags(JSDynamicObject obj)

setObjectFlags

public static void setObjectFlags(JSDynamicObject obj,
                                  int flags)

setPropertyFlags

public static void setPropertyFlags(JSDynamicObject obj,
                                    Object key,
                                    int flags)

getPropertyFlags

public static int getPropertyFlags(JSDynamicObject obj,
                                   Object key)

updatePropertyFlags

public static boolean updatePropertyFlags(JSDynamicObject obj,
                                          Object key,
                                          IntUnaryOperator updateFunction)

Update property flags, changing the object's shape if need be.

Parameters:

updateFunction - An idempotent function that returns the updated property flags based on the previous flags.

Returns:

true if successful, false if there was no such property or no change was made.

See Also:

JSDynamicObject.setPropertyFlags(JSDynamicObject, Object, int), JSDynamicObject.getPropertyFlags(JSDynamicObject, Object)

testProperties

public static boolean testProperties(JSDynamicObject obj,
                                     Predicate<com.oracle.truffle.api.object.Property> predicate)

removeKey

public static boolean removeKey(JSDynamicObject obj,
                                Object key)

getJSSharedData

public static JSSharedData getJSSharedData(JSDynamicObject obj)