com.oracle.truffle.js.runtime.builtins

Class JSString

java.lang.Object

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

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

com.oracle.truffle.js.runtime.builtins.JSPrimitive

com.oracle.truffle.js.runtime.builtins.JSString

All Implemented Interfaces:

JSConstructorFactory, JSConstructorFactory.WithFunctions, PrototypeSupplier

public final class JSString
extends JSPrimitive
implements JSConstructorFactory.WithFunctions

Property Summary

Type	Property and Description
boolean	usesOrdinaryGetOwn

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	JSString.StringLengthProxyProperty

Nested classes/interfaces inherited from interface com.oracle.truffle.js.runtime.builtins.JSConstructorFactory

JSConstructorFactory.Default, JSConstructorFactory.WithFunctions, JSConstructorFactory.WithFunctionsAndSpecies

Field Summary

Fields

Modifier and Type	Field and Description
static com.oracle.truffle.api.strings.TruffleString	CLASS_NAME
static com.oracle.truffle.api.strings.TruffleString	CLASS_NAME_EXTENSIONS
static JSString	INSTANCE
static com.oracle.truffle.api.strings.TruffleString	LENGTH
static com.oracle.truffle.api.strings.TruffleString	PROTOTYPE_NAME
static com.oracle.truffle.api.strings.TruffleString	REGEXP_ITERATOR_CLASS_NAME
static com.oracle.truffle.api.object.HiddenKey	REGEXP_ITERATOR_DONE_ID
static com.oracle.truffle.api.object.HiddenKey	REGEXP_ITERATOR_GLOBAL_ID
static com.oracle.truffle.api.object.HiddenKey	REGEXP_ITERATOR_ITERATED_STRING_ID
static com.oracle.truffle.api.object.HiddenKey	REGEXP_ITERATOR_ITERATING_REGEXP_ID
static com.oracle.truffle.api.strings.TruffleString	REGEXP_ITERATOR_PROTOTYPE_NAME
static com.oracle.truffle.api.object.HiddenKey	REGEXP_ITERATOR_UNICODE_ID
static com.oracle.truffle.api.strings.TruffleString	TRIM_END
static com.oracle.truffle.api.strings.TruffleString	TRIM_LEFT
static com.oracle.truffle.api.strings.TruffleString	TRIM_RIGHT
static com.oracle.truffle.api.strings.TruffleString	TRIM_START
static com.oracle.truffle.api.strings.TruffleString	TYPE_NAME

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

GET_SYMBOL_SPECIES_NAME

Method Summary

Modifier and Type	Method and Description
static JSStringObject	create(JSContext context, JSRealm realm, JSDynamicObject proto, com.oracle.truffle.api.strings.TruffleString value)
static JSStringObject	create(JSContext context, JSRealm realm, com.oracle.truffle.api.strings.TruffleString value)
static JSConstructor	createConstructor(JSRealm realm)
JSDynamicObject	createPrototype(JSRealm realm, JSFunctionObject ctor)
boolean	defineOwnProperty(JSDynamicObject thisObj, Object key, PropertyDescriptor desc, boolean doThrow) 9.1.6 [[DefineOwnProperty]] (P, Desc).
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.
com.oracle.truffle.api.strings.TruffleString	getClassName()
com.oracle.truffle.api.strings.TruffleString	getClassName(JSDynamicObject object) The [[Class]] internal property.
JSDynamicObject	getIntrinsicDefaultProto(JSRealm realm) Allows invokevirtual of this method instead of invokeinterface.
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).
static com.oracle.truffle.api.strings.TruffleString	getString(JSDynamicObject obj)
static int	getStringLength(JSDynamicObject obj)
boolean	hasOwnProperty(JSDynamicObject thisObj, long index)
boolean	hasOwnProperty(JSDynamicObject thisObj, Object key)
static boolean	isJSString(Object obj)
com.oracle.truffle.api.object.Shape	makeInitialShape(JSContext context, JSDynamicObject prototype)
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).
static PropertyDescriptor	stringGetIndexProperty(JSDynamicObject thisObj, Object key) ES6, 9.4.3.1.1 StringGetIndexProperty (S, P).
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.JSPrimitive

getHelper, getMethodHelper

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

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

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

defaultToString, filterOwnPropertyKeys, formatToString, get, get, getToStringTag, isInstance, isInstance, isInstance, isInstance, ownPropertyKeys, testIntegrityLevelDefault

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.oracle.truffle.js.runtime.builtins.JSConstructorFactory.WithFunctions

createConstructorAndPrototype

Methods inherited from interface com.oracle.truffle.js.runtime.builtins.JSConstructorFactory

createConstructorObject, fillConstructor

Property Detail

usesOrdinaryGetOwn

public boolean usesOrdinaryGetOwnProperty

Overrides:

usesOrdinaryGetOwnProperty in class JSNonProxy

Field Detail

INSTANCE

public static final JSString INSTANCE

TYPE_NAME

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

CLASS_NAME

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

PROTOTYPE_NAME

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

CLASS_NAME_EXTENSIONS

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

LENGTH

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

REGEXP_ITERATOR_CLASS_NAME

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

REGEXP_ITERATOR_PROTOTYPE_NAME

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

REGEXP_ITERATOR_ITERATING_REGEXP_ID

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

REGEXP_ITERATOR_ITERATED_STRING_ID

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

REGEXP_ITERATOR_GLOBAL_ID

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

REGEXP_ITERATOR_UNICODE_ID

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

REGEXP_ITERATOR_DONE_ID

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

TRIM_START

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

TRIM_END

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

TRIM_LEFT

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

TRIM_RIGHT

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

Method Detail

create

public static JSStringObject create(JSContext context,
                                    JSRealm realm,
                                    com.oracle.truffle.api.strings.TruffleString value)

create

public static JSStringObject create(JSContext context,
                                    JSRealm realm,
                                    JSDynamicObject proto,
                                    com.oracle.truffle.api.strings.TruffleString value)

hasOwnProperty

public boolean hasOwnProperty(JSDynamicObject thisObj,
                              Object key)

Overrides:

hasOwnProperty in class JSNonProxy

getString

public static com.oracle.truffle.api.strings.TruffleString getString(JSDynamicObject obj)

getStringLength

public static int getStringLength(JSDynamicObject obj)

hasOwnProperty

public boolean hasOwnProperty(JSDynamicObject thisObj,
                              long index)

Overrides:

hasOwnProperty in class JSNonProxy

getOwnHelper

public 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

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

set

public 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

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

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

createPrototype

public JSDynamicObject createPrototype(JSRealm realm,
                                       JSFunctionObject ctor)

Specified by:

createPrototype in interface JSConstructorFactory

makeInitialShape

public com.oracle.truffle.api.object.Shape makeInitialShape(JSContext context,
                                                            JSDynamicObject prototype)

Overrides:

makeInitialShape in class JSClass

createConstructor

public static JSConstructor createConstructor(JSRealm realm)

getClassName

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

Specified by:

getClassName in interface JSConstructorFactory

getClassName

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

Description copied from class: JSClass

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

Specified by:

getClassName in class JSClass

Parameters:

object - object to be used

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)

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

isJSString

public static boolean isJSString(Object obj)

getOwnProperty

public PropertyDescriptor getOwnProperty(JSDynamicObject thisObj,
                                         Object key)

Description copied from class: JSClass

9.1.5 [[GetOwnProperty]] (P).

Overrides:

getOwnProperty in class JSNonProxy

usesOrdinaryGetOwnProperty

public boolean usesOrdinaryGetOwnProperty()

Overrides:

usesOrdinaryGetOwnProperty in class JSNonProxy

defineOwnProperty

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

Description copied from class: JSClass

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

Overrides:

defineOwnProperty in class JSNonProxy

stringGetIndexProperty

public static PropertyDescriptor stringGetIndexProperty(JSDynamicObject thisObj,
                                                        Object key)

ES6, 9.4.3.1.1 StringGetIndexProperty (S, P).

getIntrinsicDefaultProto

public JSDynamicObject getIntrinsicDefaultProto(JSRealm realm)

Description copied from class: JSClass

Allows invokevirtual of this method instead of invokeinterface. Classes overriding this method should implement PrototypeSupplier.

Specified by:

getIntrinsicDefaultProto in interface PrototypeSupplier

Overrides:

getIntrinsicDefaultProto in class JSClass

See Also:

PrototypeSupplier.getIntrinsicDefaultProto(com.oracle.truffle.js.runtime.JSRealm)