Module org.htmlunit.corejs

Package org.htmlunit.corejs.javascript.typedarrays

Class NativeTypedArrayView<T>

java.lang.Object

org.htmlunit.corejs.javascript.SlotMapOwner<Scriptable>

org.htmlunit.corejs.javascript.ScriptableObject

org.htmlunit.corejs.javascript.typedarrays.NativeArrayBufferView

org.htmlunit.corejs.javascript.typedarrays.NativeTypedArrayView<T>

All Implemented Interfaces:

Serializable, Iterable<T>, Collection<T>, List<T>, RandomAccess, ConstProperties<Scriptable>, DebuggableObject, ExternalArrayData, PropHolder<Scriptable>, Scriptable, SymbolScriptable

Direct Known Subclasses:

NativeBigIntArrayView, NativeFloat16Array, NativeFloat32Array, NativeFloat64Array, NativeInt16Array, NativeInt32Array, NativeInt8Array, NativeUint16Array, NativeUint32Array, NativeUint8Array, NativeUint8ClampedArray

public abstract class NativeTypedArrayView<T>
extends NativeArrayBufferView
implements List<T>, RandomAccess, ExternalArrayData

This class is the abstract parent for all of the various typed arrays. Each one shows a view of a specific NativeArrayBuffer, and modifications here will affect the rest.

See Also:

• Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
protected static interface	NativeTypedArrayView.RealThis
protected static interface	NativeTypedArrayView.TypedArrayConstructable

Nested classes/interfaces inherited from class org.htmlunit.corejs.javascript.ScriptableObject

ScriptableObject.DescriptorInfo, ScriptableObject.KeyComparator, ScriptableObject.LambdaGetterFunction, ScriptableObject.LambdaSetterFunction

Field Summary

Fields inherited from class org.htmlunit.corejs.javascript.typedarrays.NativeArrayBufferView

arrayBuffer, byteLength, offset, outOfRange

Fields inherited from class org.htmlunit.corejs.javascript.ScriptableObject

CONST, DONTENUM, EMPTY, LEGACY_CONST, PERMANENT, READONLY, STRICTLY_READONLY, UNINITIALIZED_CONST

Fields inherited from class org.htmlunit.corejs.javascript.SlotMapOwner

isSealed

Fields inherited from interface org.htmlunit.corejs.javascript.Scriptable

NOT_FOUND

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	NativeTypedArrayView()
protected	NativeTypedArrayView(NativeArrayBuffer ab, int off, int len, int byteLen)	Construct a TypedArray view over an ArrayBuffer.

Method Summary

Modifier and Type	Method	Description
void	add(int i, T aByte)
boolean	add(T aByte)
boolean	addAll(int i, Collection<? extends T> bytes)
boolean	addAll(Collection<? extends T> bytes)
protected boolean	checkIndex(int index)	Returns true, if the index is wrong.
void	clear()
boolean	contains(Object o)
boolean	containsAll(Collection<?> objects)
protected boolean	defineOwnProperty(Context cx, Object id, ScriptableObject.DescriptorInfo desc, boolean checkValid)	Defines a property on an object.
void	delete(int index)	Removes the indexed property from the object.
void	delete(String name)	Removes a named property from the object.
protected void	ensureIndex(int index)	Enusres that the index is in the given range
boolean	equals(Object o)
Object	get(int index, Scriptable start)	Returns the value of the indexed property or NOT_FOUND.
Object	get(String name, Scriptable start)	Returns the value of the named property or NOT_FOUND.
Object	getArrayElement(int index)	Return the element at the specified index.
int	getArrayLength()	Return the length of the array.
abstract int	getBytesPerElement()	Return the number of bytes represented by each element in the array.
Object[]	getIds()	Returns an array of ids for the properties of the object.
boolean	has(int index, Scriptable start)	Returns true if the property index is defined.
boolean	has(String name, Scriptable start)	Returns true if the named property is defined.
int	hashCode()
int	indexOf(Object o)
boolean	isEmpty()
boolean	isTypedArrayOutOfBounds()	Check if this TypedArray view is out of bounds (ES2025).
Iterator<T>	iterator()
protected static NativeTypedArrayView<?>	js_constructor(Context cx, JSFunction f, Object nt, VarScope s, Object thisObj, Object[] args, NativeTypedArrayView.TypedArrayConstructable constructable, int bytesPerElement, TopLevel.Builtins type)
protected static NativeTypedArrayView<?>	js_constructor(Context cx, VarScope scope, Object[] args, NativeTypedArrayView.TypedArrayConstructable constructable, int bytesPerElement)
protected abstract Object	js_get(int index)
protected abstract Object	js_set(int index, Object c)
int	lastIndexOf(Object o)
ListIterator<T>	listIterator()
ListIterator<T>	listIterator(int start)
boolean	preventExtensions()
void	put(int index, Scriptable start, Object val)	Sets the value of the indexed property, creating it if need be.
void	put(String name, Scriptable start, Object val)	Sets the value of the named property, creating it if need be.
T	remove(int i)
boolean	remove(Object o)
boolean	removeAll(Collection<?> objects)
boolean	retainAll(Collection<?> objects)
void	setArrayElement(int index, Object value)	Set the element at the specified index.
int	size()
List<T>	subList(int i, int i2)
Object[]	toArray()
<U> U[]	toArray(U[] ts)
protected Object	toNumeric(Object num)
protected int	validateAndGetLength()	Method to allow implementation of https://tc39.es/ecma262/multipage/indexed-collections.html#sec-validatetypedarray, but only return the actual length since we don't really need to create a witness record.

Methods inherited from class org.htmlunit.corejs.javascript.typedarrays.NativeArrayBufferView

getBuffer, getByteLength, getByteOffset, isArg

Methods inherited from class org.htmlunit.corejs.javascript.ScriptableObject

applyDescriptorToAttributeBitset, avoidObjectDetection, buildDataDescriptor, callMethod, callMethod, checkNotSealed, checkPropertyChangeForSlot, checkPropertyChangeForSlot, checkPropertyDefinition, checkPropertyDefinition, checkSlotRemoval, defineBuiltinProperty, defineBuiltinProperty, defineBuiltInProperty, defineClass, defineClass, defineClass, defineConst, defineConstProperty, defineFunctionProperties, defineOwnProperties, defineOwnProperty, defineOwnProperty, defineProperty, defineProperty, defineProperty, defineProperty, defineProperty, defineProperty, defineProperty, defineProperty, defineProperty, defineProperty, delete, deleteProperty, deleteProperty, deleteProperty, ensureScriptable, ensureScriptableObject, ensureScriptableObjectButNotSymbol, ensureSymbolScriptable, ensureType, equivalentValues, get, getAllIds, getAncestor, getArrayPrototype, getClassName, getClassPrototype, getClassPrototype, getDefaultValue, getDefaultValue, getExternalArrayData, getExternalArrayLength, getFunctionPrototype, getGeneratorFunctionPrototype, getGetterOrSetter, getGetterOrSetter, getObjectPrototype, getOwnPropertyDescriptor, getParentScope, getProperty, getProperty, getProperty, getProperty, getProperty, getPropertyIds, getPrototype, getSuperProperty, getSuperProperty, getSuperProperty, getThis, getTopLevelScope, getTopScopeValue, getTypedProperty, getTypedProperty, getTypeOf, hasInstance, hasProperty, hasProperty, hasProperty, hasProperty, isAccessorDescriptor, isAccessorDescriptor, isConst, isDataDescriptor, isExtensible, isFalse, isGenericDescriptor, isGenericDescriptor, isGetterOrSetter, isGetterOrSetter, isTrue, put, putConst, putConstProperty, putConstProperty, putOwnProperty, putOwnProperty, putOwnProperty, putProperty, putProperty, putProperty, putProperty, putSuperProperty, putSuperProperty, putSuperProperty, querySlot, redefineProperty, redefineProperty, sameValue, sealObject, setCommonDescriptorProperties, setExternalArrayData, setGetterOrSetter, setParentScope, setPrototype

Methods inherited from class org.htmlunit.corejs.javascript.SlotMapOwner

associateValue, checkNotSealed, copyAssociatedValue, createSlotMap, createSlotMap, defineProperty, defineProperty, get, getAssociatedValue, getAttributes, getAttributes, getAttributes, getAttributes, getAttributes, has, isSealed, readMaps, setAttributes, setAttributes, setAttributes, setAttributes, setAttributes, writeMaps

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface java.util.Collection

parallelStream, removeIf, stream, toArray

Methods inherited from interface java.lang.Iterable

forEach

Methods inherited from interface java.util.List

get, replaceAll, set, sort, spliterator

Methods inherited from interface org.htmlunit.corejs.javascript.Scriptable

get, has

Methods inherited from interface org.htmlunit.corejs.javascript.SymbolScriptable

get, has

Constructor Details

NativeTypedArrayView

protected NativeTypedArrayView()

NativeTypedArrayView

protected NativeTypedArrayView(NativeArrayBuffer ab,
 int off,
 int len,
 int byteLen)

Construct a TypedArray view over an ArrayBuffer. If len is negative, creates an auto-length view (ES2025) that tracks the buffer's size dynamically.

Method Details

get

public Object get(int index,
 Scriptable start)

Description copied from class: ScriptableObject

Returns the value of the indexed property or NOT_FOUND.

Specified by:

get in interface PropHolder<T>

Specified by:

get in interface Scriptable

Overrides:

get in class ScriptableObject

Parameters:

index - the numeric index for the property

start - the object in which the lookup began

Returns:

the value of the property (may be null), or NOT_FOUND

See Also:

• Scriptable.get(String,Scriptable)

get

public Object get(String name,
 Scriptable start)

Description copied from class: SlotMapOwner

Returns the value of the named property or NOT_FOUND.

If the property was created using defineProperty, the appropriate getter method is called.

Specified by:

get in interface PropHolder<T>

Specified by:

get in interface Scriptable

Overrides:

get in class SlotMapOwner<Scriptable>

Parameters:

name - the name of the property

start - the object in which the lookup began

Returns:

the value of the property (may be null), or NOT_FOUND

See Also:

• Context.getUndefinedValue()

has

public boolean has(int index,
 Scriptable start)

Description copied from class: ScriptableObject

Returns true if the property index is defined.

Specified by:

has in interface PropHolder<T>

Specified by:

has in interface Scriptable

Overrides:

has in class ScriptableObject

Parameters:

index - the numeric index for the property

start - the object in which the lookup began

Returns:

true if and only if the property was found in the object

See Also:

• Scriptable.get(int, Scriptable)
• ScriptableObject.getProperty(Scriptable, int)

has

public boolean has(String name,
 Scriptable start)

Description copied from class: SlotMapOwner

Returns true if the named property is defined.

Specified by:

has in interface PropHolder<T>

Specified by:

has in interface Scriptable

Overrides:

has in class SlotMapOwner<Scriptable>

Parameters:

name - the name of the property

start - the object in which the lookup began

Returns:

true if and only if the property was found in the object

See Also:

• Scriptable.get(String, Scriptable)
• ScriptableObject.getProperty(Scriptable, String)

put

public void put(int index,
 Scriptable start,
 Object val)

Description copied from class: ScriptableObject

Sets the value of the indexed property, creating it if need be.

Specified by:

put in interface PropHolder<T>

Specified by:

put in interface Scriptable

Overrides:

put in class ScriptableObject

Parameters:

index - the numeric index for the property

start - the object whose property is being set

val - value to set the property to

See Also:

• Scriptable.has(int, Scriptable)
• Scriptable.get(int, Scriptable)
• ScriptableObject.putProperty(Scriptable, int, Object)
• Context.toObject(Object, VarScope)

put

public void put(String name,
 Scriptable start,
 Object val)

Description copied from class: ScriptableObject

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.

Specified by:

put in interface PropHolder<T>

Specified by:

put in interface Scriptable

Overrides:

put in class ScriptableObject

Parameters:

name - the name of the property

start - the object whose property is being set

val - value to set the property to

See Also:

• Scriptable.has(String, Scriptable)
• Scriptable.get(String, Scriptable)
• ScriptableObject.putProperty(Scriptable, String, Object)
• Context.toObject(Object, VarScope)

delete

public void delete(int index)

Description copied from class: ScriptableObject

Removes the indexed property from the object.

If the property is not found, or it has the PERMANENT attribute, no action is taken.

Specified by:

delete in interface PropHolder<T>

Specified by:

delete in interface Scriptable

Overrides:

delete in class ScriptableObject

Parameters:

index - the numeric index for the property

See Also:

• Scriptable.get(int, Scriptable)
• ScriptableObject.deleteProperty(Scriptable, int)

delete

public void delete(String name)

Description copied from class: ScriptableObject

Removes a named property from the object.

If the property is not found, or it has the PERMANENT attribute, no action is taken.

Specified by:

delete in interface PropHolder<T>

Specified by:

delete in interface Scriptable

Overrides:

delete in class ScriptableObject

Parameters:

name - the name of the property

See Also:

• Scriptable.get(String, Scriptable)
• ScriptableObject.deleteProperty(Scriptable, String)

getIds

public Object[] getIds()

Description copied from class: SlotMapOwner

Returns an array of ids for the properties of the object.

Any properties with the attribute DONTENUM are not listed.

Specified by:

getIds in interface PropHolder<T>

Specified by:

getIds in interface Scriptable

Overrides:

getIds in class SlotMapOwner<Scriptable>

Returns:

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.

preventExtensions

public boolean preventExtensions()

Overrides:

preventExtensions in class ScriptableObject

defineOwnProperty

protected boolean defineOwnProperty(Context cx,
 Object id,
 ScriptableObject.DescriptorInfo desc,
 boolean checkValid)

Description copied from class: ScriptableObject

Defines a property on an object.

Based on [[DefineOwnProperty]] from 8.12.10 of the spec. see [[DefineOwnProperty]]

Overrides:

defineOwnProperty in class ScriptableObject

Parameters:

cx - the current Context

id - the name/index of the property

desc - the new property descriptor, as described in 8.6.1

checkValid - whether to perform validity checks

Returns:

always true at the moment

checkIndex

protected boolean checkIndex(int index)

Returns true, if the index is wrong.

ensureIndex

protected void ensureIndex(int index)

Enusres that the index is in the given range

Throws:

IndexOutOfBoundsException - when index is out of range

getBytesPerElement

public abstract int getBytesPerElement()

Return the number of bytes represented by each element in the array. This can be useful when wishing to manipulate the byte array directly from Java.

js_get

protected abstract Object js_get(int index)

js_set

protected abstract Object js_set(int index,
 Object c)

toNumeric

protected Object toNumeric(Object num)

js_constructor

protected static NativeTypedArrayView<?> js_constructor(Context cx,
 JSFunction f,
 Object nt,
 VarScope s,
 Object thisObj,
 Object[] args,
 NativeTypedArrayView.TypedArrayConstructable constructable,
 int bytesPerElement,
 TopLevel.Builtins type)

js_constructor

protected static NativeTypedArrayView<?> js_constructor(Context cx,
 VarScope scope,
 Object[] args,
 NativeTypedArrayView.TypedArrayConstructable constructable,
 int bytesPerElement)

isTypedArrayOutOfBounds

public boolean isTypedArrayOutOfBounds()

Check if this TypedArray view is out of bounds (ES2025). For auto-length views, updates the length before checking. Returns true if the buffer is detached or the offset is out of range.

validateAndGetLength

protected int validateAndGetLength()

Method to allow implementation of https://tc39.es/ecma262/multipage/indexed-collections.html#sec-validatetypedarray, but only return the actual length since we don't really need to create a witness record.

getArrayElement

public Object getArrayElement(int index)

Description copied from interface: ExternalArrayData

Return the element at the specified index. The result must be a type that is valid in JavaScript: Number, String, or Scriptable. This method will not be called unless "index" is in range.

Specified by:

getArrayElement in interface ExternalArrayData

setArrayElement

public void setArrayElement(int index,
 Object value)

Description copied from interface: ExternalArrayData

Set the element at the specified index. This method will not be called unless "index" is in range. The method must check that "value" is a valid type, and convert it if necessary.

Specified by:

setArrayElement in interface ExternalArrayData

getArrayLength

public int getArrayLength()

Description copied from interface: ExternalArrayData

Return the length of the array.

Specified by:

getArrayLength in interface ExternalArrayData

containsAll

public boolean containsAll(Collection<?> objects)

Specified by:

containsAll in interface Collection<T>

Specified by:

containsAll in interface List<T>

indexOf

public int indexOf(Object o)

Specified by:

indexOf in interface List<T>

lastIndexOf

public int lastIndexOf(Object o)

Specified by:

lastIndexOf in interface List<T>

toArray

public Object[] toArray()

Specified by:

toArray in interface Collection<T>

Specified by:

toArray in interface List<T>

toArray

public <U> U[] toArray(U[] ts)

Specified by:

toArray in interface Collection<T>

Specified by:

toArray in interface List<T>

size

public int size()

Specified by:

size in interface Collection<T>

Specified by:

size in interface List<T>

Overrides:

size in class ScriptableObject

isEmpty

public boolean isEmpty()

Specified by:

isEmpty in interface Collection<T>

Specified by:

isEmpty in interface List<T>

Overrides:

isEmpty in class ScriptableObject

contains

public boolean contains(Object o)

Specified by:

contains in interface Collection<T>

Specified by:

contains in interface List<T>

equals

public boolean equals(Object o)

Specified by:

equals in interface Collection<T>

Specified by:

equals in interface List<T>

Overrides:

equals in class Object

hashCode

public int hashCode()

Specified by:

hashCode in interface Collection<T>

Specified by:

hashCode in interface List<T>

Overrides:

hashCode in class Object

iterator

public Iterator<T> iterator()

Specified by:

iterator in interface Collection<T>

Specified by:

iterator in interface Iterable<T>

Specified by:

iterator in interface List<T>

listIterator

public ListIterator<T> listIterator()

Specified by:

listIterator in interface List<T>

listIterator

public ListIterator<T> listIterator(int start)

Specified by:

listIterator in interface List<T>

subList

public List<T> subList(int i,
 int i2)

Specified by:

subList in interface List<T>

add

public boolean add(T aByte)

Specified by:

add in interface Collection<T>

Specified by:

add in interface List<T>

add

public void add(int i,
 T aByte)

Specified by:

add in interface List<T>

addAll

public boolean addAll(Collection<? extends T> bytes)

Specified by:

addAll in interface Collection<T>

Specified by:

addAll in interface List<T>

addAll

public boolean addAll(int i,
 Collection<? extends T> bytes)

Specified by:

addAll in interface List<T>

clear

public void clear()

Specified by:

clear in interface Collection<T>

Specified by:

clear in interface List<T>

remove

public T remove(int i)

Specified by:

remove in interface List<T>

remove

public boolean remove(Object o)

Specified by:

remove in interface Collection<T>

Specified by:

remove in interface List<T>

removeAll

public boolean removeAll(Collection<?> objects)

Specified by:

removeAll in interface Collection<T>

Specified by:

removeAll in interface List<T>

retainAll

public boolean retainAll(Collection<?> objects)

Specified by:

retainAll in interface Collection<T>

Specified by:

retainAll in interface List<T>