com.oracle.truffle.js.runtime.builtins

Class JSAbstractArray

java.lang.Object

com.oracle.truffle.js.runtime.builtins.JSClass

com.oracle.truffle.js.runtime.builtins.JSNonProxy

com.oracle.truffle.js.runtime.builtins.JSAbstractArray

Direct Known Subclasses:

JSAbstractArgumentsArray, JSArray, JSSlowArray

public abstract class JSAbstractArray
extends JSNonProxy

Property Summary

Type	Property and Description
boolean	usesOrdinaryGetOwn

Field Summary

Fields

Modifier and Type	Field and Description
protected static String	ARRAY_LENGTH_NOT_WRITABLE
static String	ARRAY_PROTOTYPE_NO_ELEMENTS_INVALIDATION
protected static String	CANNOT_REDEFINE_PROPERTY_LENGTH
static Comparator<Object>	DEFAULT_JSARRAY_COMPARATOR
static Comparator<Object>	DEFAULT_JSARRAY_DOUBLE_COMPARATOR
static Comparator<Object>	DEFAULT_JSARRAY_INTEGER_COMPARATOR
static com.oracle.truffle.api.object.HiddenKey	LAZY_REGEX_ORIGINAL_INPUT_ID
static com.oracle.truffle.api.object.HiddenKey	LAZY_REGEX_RESULT_ID
static com.oracle.truffle.api.strings.TruffleString	LENGTH
protected static String	MAKE_SLOW_ARRAY_NEVER_PART_OF_COMPILATION_MESSAGE

Fields inherited from class com.oracle.truffle.js.runtime.builtins.JSNonProxy

GET_SYMBOL_SPECIES_NAME

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	JSAbstractArray()

Method Summary

Modifier and Type	Method and Description
protected static ArrayAccess	arrayAccess()
static ArrayAllocationSite	arrayGetAllocationSite(JSDynamicObject thisObj)
static Object	arrayGetArray(JSDynamicObject thisObj)
static int	arrayGetArrayOffset(JSDynamicObject thisObj)
static ScriptArray	arrayGetArrayType(JSDynamicObject thisObj)
static int	arrayGetHoleCount(JSDynamicObject thisObj)
static long	arrayGetIndexOffset(JSDynamicObject thisObj)
static long	arrayGetLength(JSDynamicObject thisObj)
static Object	arrayGetRegexResult(JSDynamicObject thisObj, com.oracle.truffle.api.object.DynamicObjectLibrary lazyRegexResult)
static com.oracle.truffle.api.strings.TruffleString	arrayGetRegexResultOriginalInput(JSDynamicObject thisObj, com.oracle.truffle.api.object.DynamicObjectLibrary lazyRegexResultOriginalInput)
static int	arrayGetUsedLength(JSDynamicObject thisObj)
static void	arraySetArray(JSDynamicObject thisObj, Object array)
static void	arraySetArrayOffset(JSDynamicObject thisObj, int arrayOffset)
static void	arraySetArrayType(JSDynamicObject thisObj, ScriptArray arrayType)
static void	arraySetHoleCount(JSDynamicObject thisObj, int holeCount)
static void	arraySetIndexOffset(JSDynamicObject thisObj, long indexOffset)
static void	arraySetLength(JSDynamicObject thisObj, int length)
static void	arraySetLength(JSDynamicObject thisObj, long length)
static void	arraySetUsedLength(JSDynamicObject thisObj, int usedLength)
boolean	defineOwnProperty(JSDynamicObject thisObj, Object key, PropertyDescriptor descriptor, boolean doThrow) 9.1.6 [[DefineOwnProperty]] (P, Desc).
protected boolean	defineOwnPropertyIndex(JSDynamicObject thisObj, com.oracle.truffle.api.strings.TruffleString name, PropertyDescriptor descriptor, boolean doThrow) Implements part "3" of 15.4.5.1 [[DefineOwnProperty]], redefining one of the index property of an Array.
boolean	delete(JSDynamicObject thisObj, long index, boolean isStrict)
boolean	delete(JSDynamicObject thisObj, Object key, boolean isStrict) 9.1.10 [[Delete]] (P).
com.oracle.truffle.api.strings.TruffleString	getBuiltinToStringTag(JSDynamicObject object) Returns builtinTag from step 14 of ES6+ 19.1.3.6.
long	getLength(JSDynamicObject thisObj)
Object	getOwnHelper(JSDynamicObject store, Object thisObj, long index, com.oracle.truffle.api.nodes.Node encapsulatingNode) Like getOwnProperty, but returns null if value is not present instead of undefined.
Object	getOwnHelper(JSDynamicObject store, Object thisObj, Object key, com.oracle.truffle.api.nodes.Node encapsulatingNode) Like getOwnProperty, but returns null if value is not present instead of undefined.
PropertyDescriptor	getOwnProperty(JSDynamicObject thisObj, Object key) 9.1.5 [[GetOwnProperty]] (P).
List<Object>	getOwnPropertyKeys(JSDynamicObject thisObj, boolean strings, boolean symbols) GetOwnPropertyKeys (O, type).
boolean	hasOwnProperty(JSDynamicObject thisObj, long index)
boolean	hasOwnProperty(JSDynamicObject thisObj, Object key)
protected boolean	isSlowArray(JSDynamicObject thisObj)
protected JSDynamicObject	makeSlowArray(JSDynamicObject thisObj)
static PropertyDescriptor	ordinaryGetOwnPropertyArray(JSDynamicObject thisObj, Object key) 9.1.5.1 OrdinaryGetOwnProperty (O, P), implemented for Arrays.
protected static List<Object>	ownPropertyKeysFastArray(JSDynamicObject thisObj, boolean strings, boolean symbols)
protected static List<Object>	ownPropertyKeysSlowArray(JSDynamicObject thisObj, boolean strings, boolean symbols)
boolean	preventExtensions(JSDynamicObject thisObj, boolean doThrow) 9.1.4 [[PreventExtensions]] ().
boolean	set(JSDynamicObject thisObj, long index, Object value, Object receiver, boolean isStrict, com.oracle.truffle.api.nodes.Node encapsulatingNode)
boolean	set(JSDynamicObject thisObj, Object key, Object value, Object receiver, boolean isStrict, com.oracle.truffle.api.nodes.Node encapsulatingNode) 9.1.9 [[Set]] (P, V, Receiver).
boolean	setIntegrityLevel(JSDynamicObject thisObj, boolean freeze, boolean doThrow) ES2015 7.3.14 SetIntegrityLevel(O, level).
boolean	setLength(JSDynamicObject thisObj, long length, boolean doThrow)
boolean	testIntegrityLevel(JSDynamicObject thisObj, boolean frozen) ES2015 7.3.15 TestIntegrityLevel(O, level).
static Object[]	toArray(JSDynamicObject thisObj) Creates an Object[] from this array, of size array.length.
static long	toArrayLengthOrRangeError(Number len, Number len32, com.oracle.truffle.api.nodes.Node originatingNode)
static long	toArrayLengthOrRangeError(Object obj, com.oracle.truffle.api.nodes.Node originatingNode)
com.oracle.truffle.api.strings.TruffleString	toDisplayStringImpl(JSDynamicObject obj, boolean allowSideEffects, ToDisplayStringFormat format, int depth) A more informative toString variant, mainly used for error messages.
boolean	usesOrdinaryGetOwnProperty()

Methods inherited from class com.oracle.truffle.js.runtime.builtins.JSNonProxy

checkProtoCycle, createSymbolSpeciesGetterFunction, deletePropertyDefault, getHelper, getHelper, getMethodHelper, getPrototypeOf, hasOnlyShapeProperties, hasProperty, hasProperty, invokeAccessorPropertySetter, isExtensible, ordinaryGetOwnProperty, ordinaryGetOwnPropertyIntl, ordinaryIsExtensible, ordinaryOwnPropertyKeys, ordinaryOwnPropertyKeys, ordinaryOwnPropertyKeysSlow, ordinarySet, ordinarySetIndex, ordinarySetWithReceiver, performOrdinarySetWithOwnDescriptor, preventExtensionsImpl, putConstructorSpeciesGetter, setIntegrityLevelFast, setPropertySlow, setPrototypeOf, testIntegrityLevelFast, toString, usesOrdinaryIsExtensible

Methods inherited from class com.oracle.truffle.js.runtime.builtins.JSClass

defaultToString, filterOwnPropertyKeys, formatToString, get, get, getClassName, getIntrinsicDefaultProto, getToStringTag, isInstance, isInstance, isInstance, isInstance, makeInitialShape, ownPropertyKeys, testIntegrityLevelDefault

Methods inherited from class java.lang.Object

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

Property Detail

usesOrdinaryGetOwn

public boolean usesOrdinaryGetOwnProperty

Overrides:

usesOrdinaryGetOwnProperty in class JSNonProxy

Field Detail

LENGTH

public static final com.oracle.truffle.api.strings.TruffleString LENGTH

ARRAY_LENGTH_NOT_WRITABLE

protected static final String ARRAY_LENGTH_NOT_WRITABLE

See Also:

Constant Field Values

CANNOT_REDEFINE_PROPERTY_LENGTH

protected static final String CANNOT_REDEFINE_PROPERTY_LENGTH

See Also:

Constant Field Values

MAKE_SLOW_ARRAY_NEVER_PART_OF_COMPILATION_MESSAGE

protected static final String MAKE_SLOW_ARRAY_NEVER_PART_OF_COMPILATION_MESSAGE

See Also:

Constant Field Values

ARRAY_PROTOTYPE_NO_ELEMENTS_INVALIDATION

public static final String ARRAY_PROTOTYPE_NO_ELEMENTS_INVALIDATION

See Also:

Constant Field Values

LAZY_REGEX_RESULT_ID

public static final com.oracle.truffle.api.object.HiddenKey LAZY_REGEX_RESULT_ID

LAZY_REGEX_ORIGINAL_INPUT_ID

public static final com.oracle.truffle.api.object.HiddenKey LAZY_REGEX_ORIGINAL_INPUT_ID

DEFAULT_JSARRAY_COMPARATOR

public static final Comparator<Object> DEFAULT_JSARRAY_COMPARATOR

DEFAULT_JSARRAY_INTEGER_COMPARATOR

public static final Comparator<Object> DEFAULT_JSARRAY_INTEGER_COMPARATOR

DEFAULT_JSARRAY_DOUBLE_COMPARATOR

public static final Comparator<Object> DEFAULT_JSARRAY_DOUBLE_COMPARATOR

Constructor Detail

JSAbstractArray

protected JSAbstractArray()

Method Detail

arrayGetArrayType

public static ScriptArray arrayGetArrayType(JSDynamicObject thisObj)

arrayGetLength

public static long arrayGetLength(JSDynamicObject thisObj)

arrayGetUsedLength

public static int arrayGetUsedLength(JSDynamicObject thisObj)

arrayGetIndexOffset

public static long arrayGetIndexOffset(JSDynamicObject thisObj)

arrayGetArrayOffset

public static int arrayGetArrayOffset(JSDynamicObject thisObj)

arraySetArrayType

public static void arraySetArrayType(JSDynamicObject thisObj,
                                     ScriptArray arrayType)

arraySetLength

public static void arraySetLength(JSDynamicObject thisObj,
                                  int length)

arraySetLength

public static void arraySetLength(JSDynamicObject thisObj,
                                  long length)

arraySetUsedLength

public static void arraySetUsedLength(JSDynamicObject thisObj,
                                      int usedLength)

arraySetIndexOffset

public static void arraySetIndexOffset(JSDynamicObject thisObj,
                                       long indexOffset)

arraySetArrayOffset

public static void arraySetArrayOffset(JSDynamicObject thisObj,
                                       int arrayOffset)

arrayGetArray

public static Object arrayGetArray(JSDynamicObject thisObj)

arraySetArray

public static void arraySetArray(JSDynamicObject thisObj,
                                 Object array)

arrayGetHoleCount

public static int arrayGetHoleCount(JSDynamicObject thisObj)

arraySetHoleCount

public static void arraySetHoleCount(JSDynamicObject thisObj,
                                     int holeCount)

arrayGetAllocationSite

public static ArrayAllocationSite arrayGetAllocationSite(JSDynamicObject thisObj)

arrayGetRegexResult

public static Object arrayGetRegexResult(JSDynamicObject thisObj,
                                         com.oracle.truffle.api.object.DynamicObjectLibrary lazyRegexResult)

arrayGetRegexResultOriginalInput

public static com.oracle.truffle.api.strings.TruffleString arrayGetRegexResultOriginalInput(JSDynamicObject thisObj,
                                                                                            com.oracle.truffle.api.object.DynamicObjectLibrary lazyRegexResultOriginalInput)

arrayAccess

protected static final ArrayAccess arrayAccess()

getLength

public long getLength(JSDynamicObject thisObj)

setLength

public boolean setLength(JSDynamicObject thisObj,
                         long length,
                         boolean doThrow)

getBuiltinToStringTag

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

Description copied from class: JSClass

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

Overrides:

getBuiltinToStringTag in class JSNonProxy

Parameters:

object - object to be used

Returns:

"Object" by default

See Also:

JSClass.defaultToString(JSDynamicObject)

getOwnHelper

public final Object getOwnHelper(JSDynamicObject store,
                                 Object thisObj,
                                 Object key,
                                 com.oracle.truffle.api.nodes.Node encapsulatingNode)

Description copied from class: JSNonProxy

Like getOwnProperty, but returns null if value is not present instead of undefined.

Overrides:

getOwnHelper in class JSNonProxy

set

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

Description copied from class: JSClass

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

Overrides:

set in class JSNonProxy

set

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

Overrides:

set in class JSNonProxy

delete

public boolean delete(JSDynamicObject thisObj,
                      long index,
                      boolean isStrict)

Overrides:

delete in class JSNonProxy

getOwnHelper

public Object getOwnHelper(JSDynamicObject store,
                           Object thisObj,
                           long index,
                           com.oracle.truffle.api.nodes.Node encapsulatingNode)

Description copied from class: JSNonProxy

Like getOwnProperty, but returns null if value is not present instead of undefined.

Overrides:

getOwnHelper in class JSNonProxy

toArray

public static Object[] toArray(JSDynamicObject thisObj)

Creates an Object[] from this array, of size array.length. Does not check the prototype chain, i.e. result can be wrong. Use JSToObjectArrayNode for more correct results. This is mostly used in tests, but also in a few places in Node.js.

hasOwnProperty

public final boolean hasOwnProperty(JSDynamicObject thisObj,
                                    Object key)

Overrides:

hasOwnProperty in class JSNonProxy

hasOwnProperty

public final boolean hasOwnProperty(JSDynamicObject thisObj,
                                    long index)

Overrides:

hasOwnProperty in class JSNonProxy

getOwnPropertyKeys

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

Description copied from class: JSClass

GetOwnPropertyKeys (O, type).

Overrides:

getOwnPropertyKeys in class JSNonProxy

Returns:

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

ownPropertyKeysFastArray

protected static List<Object> ownPropertyKeysFastArray(JSDynamicObject thisObj,
                                                       boolean strings,
                                                       boolean symbols)

ownPropertyKeysSlowArray

protected static List<Object> ownPropertyKeysSlowArray(JSDynamicObject thisObj,
                                                       boolean strings,
                                                       boolean symbols)

toArrayLengthOrRangeError

public static long toArrayLengthOrRangeError(Object obj,
                                             com.oracle.truffle.api.nodes.Node originatingNode)

toArrayLengthOrRangeError

public static long toArrayLengthOrRangeError(Number len,
                                             Number len32,
                                             com.oracle.truffle.api.nodes.Node originatingNode)

defineOwnProperty

public boolean defineOwnProperty(JSDynamicObject thisObj,
                                 Object key,
                                 PropertyDescriptor descriptor,
                                 boolean doThrow)

Description copied from class: JSClass

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

Overrides:

defineOwnProperty in class JSNonProxy

defineOwnPropertyIndex

protected boolean defineOwnPropertyIndex(JSDynamicObject thisObj,
                                         com.oracle.truffle.api.strings.TruffleString name,
                                         PropertyDescriptor descriptor,
                                         boolean doThrow)

Implements part "3" of 15.4.5.1 [[DefineOwnProperty]], redefining one of the index property of an Array.

Returns:

whether the operation was successful

makeSlowArray

protected JSDynamicObject makeSlowArray(JSDynamicObject thisObj)

testIntegrityLevel

public boolean testIntegrityLevel(JSDynamicObject thisObj,
                                  boolean frozen)

Description copied from class: JSNonProxy

ES2015 7.3.15 TestIntegrityLevel(O, level).

Overrides:

testIntegrityLevel in class JSNonProxy

setIntegrityLevel

public boolean setIntegrityLevel(JSDynamicObject thisObj,
                                 boolean freeze,
                                 boolean doThrow)

Description copied from class: JSClass

ES2015 7.3.14 SetIntegrityLevel(O, level).

Overrides:

setIntegrityLevel in class JSNonProxy

preventExtensions

public final boolean preventExtensions(JSDynamicObject thisObj,
                                       boolean doThrow)

Description copied from class: JSClass

9.1.4 [[PreventExtensions]] ().

Overrides:

preventExtensions in class JSNonProxy

delete

public boolean delete(JSDynamicObject thisObj,
                      Object key,
                      boolean isStrict)

Description copied from class: JSClass

9.1.10 [[Delete]] (P).

Overrides:

delete in class JSNonProxy

getOwnProperty

public PropertyDescriptor getOwnProperty(JSDynamicObject thisObj,
                                         Object key)

Description copied from class: JSClass

9.1.5 [[GetOwnProperty]] (P).

Overrides:

getOwnProperty in class JSNonProxy

ordinaryGetOwnPropertyArray

public static PropertyDescriptor ordinaryGetOwnPropertyArray(JSDynamicObject thisObj,
                                                             Object key)

9.1.5.1 OrdinaryGetOwnProperty (O, P), implemented for Arrays.

toDisplayStringImpl

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

Description copied from class: JSClass

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

Overrides:

toDisplayStringImpl in class JSNonProxy

format - formatting parameters

depth - current nesting depth

isSlowArray

protected boolean isSlowArray(JSDynamicObject thisObj)

usesOrdinaryGetOwnProperty

public boolean usesOrdinaryGetOwnProperty()

Overrides:

usesOrdinaryGetOwnProperty in class JSNonProxy