com.oracle.truffle.js.runtime.interop

Class JSInteropUtil

java.lang.Object

com.oracle.truffle.js.runtime.interop.JSInteropUtil

public final class JSInteropUtil
extends Object

Utility class for interop operations. Provides methods that can be used in Cached annotations of the TruffleDSL to create interop nodes just for specific specializations.

Method Summary

Modifier and Type	Method and Description
static Object	call(Object function, Object[] args)
static Object	construct(Object target, Object[] args)
static ByteBuffer	foreignInteropBufferAsByteBuffer(Object foreignInteropBuffer, com.oracle.truffle.api.interop.InteropLibrary interop, JSRealm realm)
static String	formatError(Object error, com.oracle.truffle.api.interop.InteropLibrary interopExc, com.oracle.truffle.api.interop.InteropLibrary interopStr)
static PropertyDescriptor	getArrayElementProperty(Object object, long index, com.oracle.truffle.api.interop.InteropLibrary interop, ImportValueNode importValueNode)
static long	getArraySize(Object foreignObj, com.oracle.truffle.api.interop.InteropLibrary interop, com.oracle.truffle.api.nodes.Node originatingNode)
static PropertyDescriptor	getExistingMemberProperty(Object object, String key, com.oracle.truffle.api.interop.InteropLibrary interop, ImportValueNode importValueNode)
static PropertyDescriptor	getOwnProperty(Object object, com.oracle.truffle.api.strings.TruffleString propertyKey)
static PropertyDescriptor	getOwnProperty(Object object, com.oracle.truffle.api.strings.TruffleString propertyKey, com.oracle.truffle.api.interop.InteropLibrary interop, ImportValueNode importValueNode, com.oracle.truffle.api.strings.TruffleString.ReadCharUTF16Node charAtNode)
static boolean	hasProperty(Object obj, Object key)
static boolean	isBoxedPrimitive(Object receiver, com.oracle.truffle.api.interop.InteropLibrary interop)
static ByteBuffer	jsInteropBufferAsByteBuffer(JSArrayBufferObject interopArrayBuffer, com.oracle.truffle.api.interop.InteropLibrary interop, JSRealm realm)
static List<Object>	keys(Object obj)
static Object	readArrayElementOrDefault(Object obj, long index, Object defaultValue)
static Object	readArrayElementOrDefault(Object obj, long index, Object defaultValue, com.oracle.truffle.api.interop.InteropLibrary interop, ImportValueNode importValue, com.oracle.truffle.api.nodes.Node originatingNode)
static Object	readMemberOrDefault(Object obj, Object member, Object defaultValue)
static Object	readMemberOrDefault(Object obj, Object member, Object defaultValue, com.oracle.truffle.api.interop.InteropLibrary interop, ImportValueNode importValue, com.oracle.truffle.api.nodes.Node originatingNode)
static boolean	remove(Object obj, Object key)
static boolean	setArraySize(Object obj, Object value, boolean isStrict, com.oracle.truffle.api.interop.InteropLibrary interop, com.oracle.truffle.api.nodes.Node originatingNode, com.oracle.truffle.api.profiles.BranchProfile errorBranch)
static Object	toPrimitiveOrDefaultLossless(Object obj, Object defaultValue, com.oracle.truffle.api.interop.InteropLibrary interop, com.oracle.truffle.api.strings.TruffleString.SwitchEncodingNode switchEncoding, com.oracle.truffle.api.nodes.Node originatingNode) Converts a foreign object to a JS primitive value.
static Object	toPrimitiveOrDefaultLossy(Object obj, Object defaultValue, com.oracle.truffle.api.interop.InteropLibrary interop, com.oracle.truffle.api.nodes.Node originatingNode) Converts foreign objects to JS primitive values, coercing all numbers to double precision.
static void	writeMember(Object obj, Object member, Object value)
static void	writeMember(Object obj, Object member, Object value, com.oracle.truffle.api.interop.InteropLibrary interop, ExportValueNode exportValue, com.oracle.truffle.api.nodes.Node originatingNode)

Methods inherited from class java.lang.Object

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

Method Detail

getArraySize

public static long getArraySize(Object foreignObj,
                                com.oracle.truffle.api.interop.InteropLibrary interop,
                                com.oracle.truffle.api.nodes.Node originatingNode)

setArraySize

public static boolean setArraySize(Object obj,
                                   Object value,
                                   boolean isStrict,
                                   com.oracle.truffle.api.interop.InteropLibrary interop,
                                   com.oracle.truffle.api.nodes.Node originatingNode,
                                   com.oracle.truffle.api.profiles.BranchProfile errorBranch)

readMemberOrDefault

public static Object readMemberOrDefault(Object obj,
                                         Object member,
                                         Object defaultValue)

readMemberOrDefault

public static Object readMemberOrDefault(Object obj,
                                         Object member,
                                         Object defaultValue,
                                         com.oracle.truffle.api.interop.InteropLibrary interop,
                                         ImportValueNode importValue,
                                         com.oracle.truffle.api.nodes.Node originatingNode)

readArrayElementOrDefault

public static Object readArrayElementOrDefault(Object obj,
                                               long index,
                                               Object defaultValue,
                                               com.oracle.truffle.api.interop.InteropLibrary interop,
                                               ImportValueNode importValue,
                                               com.oracle.truffle.api.nodes.Node originatingNode)

readArrayElementOrDefault

public static Object readArrayElementOrDefault(Object obj,
                                               long index,
                                               Object defaultValue)

writeMember

public static void writeMember(Object obj,
                               Object member,
                               Object value)

writeMember

public static void writeMember(Object obj,
                               Object member,
                               Object value,
                               com.oracle.truffle.api.interop.InteropLibrary interop,
                               ExportValueNode exportValue,
                               com.oracle.truffle.api.nodes.Node originatingNode)

toPrimitiveOrDefaultLossy

public static Object toPrimitiveOrDefaultLossy(Object obj,
                                               Object defaultValue,
                                               com.oracle.truffle.api.interop.InteropLibrary interop,
                                               com.oracle.truffle.api.nodes.Node originatingNode)

Converts foreign objects to JS primitive values, coercing all numbers to double precision.

toPrimitiveOrDefaultLossless

public static Object toPrimitiveOrDefaultLossless(Object obj,
                                                  Object defaultValue,
                                                  com.oracle.truffle.api.interop.InteropLibrary interop,
                                                  com.oracle.truffle.api.strings.TruffleString.SwitchEncodingNode switchEncoding,
                                                  com.oracle.truffle.api.nodes.Node originatingNode)

Converts a foreign object to a JS primitive value. Attempts to keep the precise numeric value when converting foreign numbers, relevant for comparisons and ToString/ToBigInt conversion. Returned BigInt values are marked as foreign so that they are handled correctly by subsequent ToNumeric, ToNumber (i.e., coerced to double), or ToBigInt.

keys

public static List<Object> keys(Object obj)

hasProperty

public static boolean hasProperty(Object obj,
                                  Object key)

remove

public static boolean remove(Object obj,
                             Object key)

call

public static Object call(Object function,
                          Object[] args)

construct

public static Object construct(Object target,
                               Object[] args)

isBoxedPrimitive

public static boolean isBoxedPrimitive(Object receiver,
                                       com.oracle.truffle.api.interop.InteropLibrary interop)

getOwnProperty

public static PropertyDescriptor getOwnProperty(Object object,
                                                com.oracle.truffle.api.strings.TruffleString propertyKey)

getOwnProperty

public static PropertyDescriptor getOwnProperty(Object object,
                                                com.oracle.truffle.api.strings.TruffleString propertyKey,
                                                com.oracle.truffle.api.interop.InteropLibrary interop,
                                                ImportValueNode importValueNode,
                                                com.oracle.truffle.api.strings.TruffleString.ReadCharUTF16Node charAtNode)

getExistingMemberProperty

public static PropertyDescriptor getExistingMemberProperty(Object object,
                                                           String key,
                                                           com.oracle.truffle.api.interop.InteropLibrary interop,
                                                           ImportValueNode importValueNode)
                                                    throws com.oracle.truffle.api.interop.InteropException

Throws:

com.oracle.truffle.api.interop.InteropException

getArrayElementProperty

public static PropertyDescriptor getArrayElementProperty(Object object,
                                                         long index,
                                                         com.oracle.truffle.api.interop.InteropLibrary interop,
                                                         ImportValueNode importValueNode)
                                                  throws com.oracle.truffle.api.interop.InteropException

Throws:

com.oracle.truffle.api.interop.InteropException

formatError

public static String formatError(Object error,
                                 com.oracle.truffle.api.interop.InteropLibrary interopExc,
                                 com.oracle.truffle.api.interop.InteropLibrary interopStr)

jsInteropBufferAsByteBuffer

public static ByteBuffer jsInteropBufferAsByteBuffer(JSArrayBufferObject interopArrayBuffer,
                                                     com.oracle.truffle.api.interop.InteropLibrary interop,
                                                     JSRealm realm)

foreignInteropBufferAsByteBuffer

public static ByteBuffer foreignInteropBufferAsByteBuffer(Object foreignInteropBuffer,
                                                          com.oracle.truffle.api.interop.InteropLibrary interop,
                                                          JSRealm realm)