#pragma warning disable CA1859 // Use concrete types when possible for improved performance -- most of prototype methods return JsValue
using Jint.Native.ArrayBuffer;
using Jint.Native.Object;
using Jint.Native.Symbol;
using Jint.Native.TypedArray;
using Jint.Runtime;
using Jint.Runtime.Descriptors;
using Jint.Runtime.Interop;
namespace Jint.Native.DataView;
///
/// https://tc39.es/ecma262/#sec-properties-of-the-dataview-prototype-object
///
internal sealed class DataViewPrototype : Prototype
{
private readonly DataViewConstructor _constructor;
internal DataViewPrototype(
Engine engine,
DataViewConstructor constructor,
ObjectPrototype objectPrototype) : base(engine, engine.Realm)
{
_prototype = objectPrototype;
_constructor = constructor;
}
protected override void Initialize()
{
const PropertyFlag lengthFlags = PropertyFlag.Configurable;
const PropertyFlag propertyFlags = PropertyFlag.Configurable | PropertyFlag.Writable;
var properties = new PropertyDictionary(26, checkExistingKeys: false)
{
["buffer"] = new GetSetPropertyDescriptor(new ClrFunction(_engine, "get buffer", Buffer, 0, lengthFlags), Undefined, PropertyFlag.Configurable),
["byteLength"] = new GetSetPropertyDescriptor(new ClrFunction(_engine, "get byteLength", ByteLength, 0, lengthFlags), Undefined, PropertyFlag.Configurable),
["byteOffset"] = new GetSetPropertyDescriptor(new ClrFunction(Engine, "get byteOffset", ByteOffset, 0, lengthFlags), Undefined, PropertyFlag.Configurable),
["constructor"] = new PropertyDescriptor(_constructor, PropertyFlag.NonEnumerable),
["getBigInt64"] = new PropertyDescriptor(new ClrFunction(Engine, "getBigInt64", GetBigInt64, length: 1, lengthFlags), propertyFlags),
["getBigUint64"] = new PropertyDescriptor(new ClrFunction(Engine, "getBigUint64", GetBigUint64, length: 1, lengthFlags), propertyFlags),
["getFloat16"] = new PropertyDescriptor(new ClrFunction(Engine, "getFloat16", GetFloat16, length: 1, lengthFlags), propertyFlags),
["getFloat32"] = new PropertyDescriptor(new ClrFunction(Engine, "getFloat32", GetFloat32, length: 1, lengthFlags), propertyFlags),
["getFloat64"] = new PropertyDescriptor(new ClrFunction(Engine, "getFloat64", GetFloat64, length: 1, lengthFlags), propertyFlags),
["getInt8"] = new PropertyDescriptor(new ClrFunction(Engine, "getInt8", GetInt8, length: 1, lengthFlags), propertyFlags),
["getInt16"] = new PropertyDescriptor(new ClrFunction(Engine, "getInt16", GetInt16, length: 1, lengthFlags), propertyFlags),
["getInt32"] = new PropertyDescriptor(new ClrFunction(Engine, "getInt32", GetInt32, length: 1, lengthFlags), propertyFlags),
["getUint8"] = new PropertyDescriptor(new ClrFunction(Engine, "getUint8", GetUint8, length: 1, lengthFlags), propertyFlags),
["getUint16"] = new PropertyDescriptor(new ClrFunction(Engine, "getUint16", GetUint16, length: 1, lengthFlags), propertyFlags),
["getUint32"] = new PropertyDescriptor(new ClrFunction(Engine, "getUint32", GetUint32, length: 1, lengthFlags), propertyFlags),
["setBigInt64"] = new PropertyDescriptor(new ClrFunction(Engine, "setBigInt64", SetBigInt64, length: 2, lengthFlags), propertyFlags),
["setBigUint64"] = new PropertyDescriptor(new ClrFunction(Engine, "setBigUint64", SetBigUint64, length: 2, lengthFlags), propertyFlags),
["setFloat16"] = new PropertyDescriptor(new ClrFunction(Engine, "setFloat16", SetFloat16, length: 2, lengthFlags), propertyFlags),
["setFloat32"] = new PropertyDescriptor(new ClrFunction(Engine, "setFloat32", SetFloat32, length: 2, lengthFlags), propertyFlags),
["setFloat64"] = new PropertyDescriptor(new ClrFunction(Engine, "setFloat64", SetFloat64, length: 2, lengthFlags), propertyFlags),
["setInt8"] = new PropertyDescriptor(new ClrFunction(Engine, "setInt8", SetInt8, length: 2, lengthFlags), propertyFlags),
["setInt16"] = new PropertyDescriptor(new ClrFunction(Engine, "setInt16", SetInt16, length: 2, lengthFlags), propertyFlags),
["setInt32"] = new PropertyDescriptor(new ClrFunction(Engine, "setInt32", SetInt32, length: 2, lengthFlags), propertyFlags),
["setUint8"] = new PropertyDescriptor(new ClrFunction(Engine, "setUint8", SetUint8, length: 2, lengthFlags), propertyFlags),
["setUint16"] = new PropertyDescriptor(new ClrFunction(Engine, "setUint16", SetUint16, length: 2, lengthFlags), propertyFlags),
["setUint32"] = new PropertyDescriptor(new ClrFunction(Engine, "setUint32", SetUint32, length: 2, lengthFlags), propertyFlags)
};
SetProperties(properties);
var symbols = new SymbolDictionary(1) { [GlobalSymbolRegistry.ToStringTag] = new PropertyDescriptor("DataView", PropertyFlag.Configurable) };
SetSymbols(symbols);
}
///
/// https://tc39.es/ecma262/#sec-get-dataview.prototype.buffer
///
private JsValue Buffer(JsValue thisObject, JsCallArguments arguments)
{
var o = thisObject as JsDataView;
if (o is null)
{
Throw.TypeError(_realm, "Method get DataView.prototype.buffer called on incompatible receiver " + thisObject);
}
return o._viewedArrayBuffer!;
}
///
/// https://tc39.es/ecma262/#sec-get-dataview.prototype.bytelength
///
private JsValue ByteLength(JsValue thisObject, JsCallArguments arguments)
{
var o = thisObject as JsDataView;
if (o is null)
{
Throw.TypeError(_realm, "Method get DataView.prototype.byteLength called on incompatible receiver " + thisObject);
}
var viewRecord = MakeDataViewWithBufferWitnessRecord(o, ArrayBufferOrder.SeqCst);
if (viewRecord.IsViewOutOfBounds)
{
Throw.TypeError(_realm, "Offset is outside the bounds of the DataView");
}
var buffer = o._viewedArrayBuffer!;
buffer.AssertNotDetached();
return JsNumber.Create(viewRecord.ViewByteLength);
}
///
/// https://tc39.es/ecma262/#sec-get-dataview.prototype.byteoffset
///
private JsValue ByteOffset(JsValue thisObject, JsCallArguments arguments)
{
var o = thisObject as JsDataView;
if (o is null)
{
Throw.TypeError(_realm, "Method get DataView.prototype.byteOffset called on incompatible receiver " + thisObject);
}
var viewRecord = MakeDataViewWithBufferWitnessRecord(o, ArrayBufferOrder.SeqCst);
if (viewRecord.IsViewOutOfBounds)
{
Throw.TypeError(_realm, "Offset is outside the bounds of the DataView");
}
var buffer = o._viewedArrayBuffer!;
buffer.AssertNotDetached();
return JsNumber.Create(o._byteOffset);
}
private JsValue GetBigInt64(JsValue thisObject, JsCallArguments arguments)
{
return GetViewValue(thisObject, arguments.At(0), arguments.At(1), TypedArrayElementType.BigInt64);
}
private JsValue GetBigUint64(JsValue thisObject, JsCallArguments arguments)
{
return GetViewValue(thisObject, arguments.At(0), arguments.At(1), TypedArrayElementType.BigUint64);
}
private JsValue GetFloat16(JsValue thisObject, JsCallArguments arguments)
{
return GetViewValue(thisObject, arguments.At(0), arguments.At(1, JsBoolean.False), TypedArrayElementType.Float16);
}
private JsValue GetFloat32(JsValue thisObject, JsCallArguments arguments)
{
return GetViewValue(thisObject, arguments.At(0), arguments.At(1, JsBoolean.False), TypedArrayElementType.Float32);
}
private JsValue GetFloat64(JsValue thisObject, JsCallArguments arguments)
{
return GetViewValue(thisObject, arguments.At(0), arguments.At(1, JsBoolean.False), TypedArrayElementType.Float64);
}
private JsValue GetInt8(JsValue thisObject, JsCallArguments arguments)
{
return GetViewValue(thisObject, arguments.At(0), JsBoolean.True, TypedArrayElementType.Int8);
}
private JsValue GetInt16(JsValue thisObject, JsCallArguments arguments)
{
return GetViewValue(thisObject, arguments.At(0), arguments.At(1, JsBoolean.False), TypedArrayElementType.Int16);
}
private JsValue GetInt32(JsValue thisObject, JsCallArguments arguments)
{
return GetViewValue(thisObject, arguments.At(0), arguments.At(1, JsBoolean.False), TypedArrayElementType.Int32);
}
private JsValue GetUint8(JsValue thisObject, JsCallArguments arguments)
{
return GetViewValue(thisObject, arguments.At(0), JsBoolean.True, TypedArrayElementType.Uint8);
}
private JsValue GetUint16(JsValue thisObject, JsCallArguments arguments)
{
return GetViewValue(thisObject, arguments.At(0), arguments.At(1, JsBoolean.False), TypedArrayElementType.Uint16);
}
private JsValue GetUint32(JsValue thisObject, JsCallArguments arguments)
{
return GetViewValue(thisObject, arguments.At(0), arguments.At(1, JsBoolean.False), TypedArrayElementType.Uint32);
}
private JsValue SetBigInt64(JsValue thisObject, JsCallArguments arguments)
{
return SetViewValue(thisObject, arguments.At(0), arguments.At(2), TypedArrayElementType.BigInt64, arguments.At(1));
}
private JsValue SetBigUint64(JsValue thisObject, JsCallArguments arguments)
{
return SetViewValue(thisObject, arguments.At(0), arguments.At(2), TypedArrayElementType.BigUint64, arguments.At(1));
}
private JsValue SetFloat16(JsValue thisObject, JsCallArguments arguments)
{
return SetViewValue(thisObject, arguments.At(0), arguments.At(2, JsBoolean.False), TypedArrayElementType.Float16, arguments.At(1));
}
private JsValue SetFloat32(JsValue thisObject, JsCallArguments arguments)
{
return SetViewValue(thisObject, arguments.At(0), arguments.At(2, JsBoolean.False), TypedArrayElementType.Float32, arguments.At(1));
}
private JsValue SetFloat64(JsValue thisObject, JsCallArguments arguments)
{
return SetViewValue(thisObject, arguments.At(0), arguments.At(2, JsBoolean.False), TypedArrayElementType.Float64, arguments.At(1));
}
private JsValue SetInt8(JsValue thisObject, JsCallArguments arguments)
{
return SetViewValue(thisObject, arguments.At(0), JsBoolean.True, TypedArrayElementType.Int8, arguments.At(1));
}
private JsValue SetInt16(JsValue thisObject, JsCallArguments arguments)
{
return SetViewValue(thisObject, arguments.At(0), arguments.At(2, JsBoolean.False), TypedArrayElementType.Int16, arguments.At(1));
}
private JsValue SetInt32(JsValue thisObject, JsCallArguments arguments)
{
return SetViewValue(thisObject, arguments.At(0), arguments.At(2, JsBoolean.False), TypedArrayElementType.Int32, arguments.At(1));
}
private JsValue SetUint8(JsValue thisObject, JsCallArguments arguments)
{
return SetViewValue(thisObject, arguments.At(0), JsBoolean.True, TypedArrayElementType.Uint8, arguments.At(1));
}
private JsValue SetUint16(JsValue thisObject, JsCallArguments arguments)
{
return SetViewValue(thisObject, arguments.At(0), arguments.At(2, JsBoolean.False), TypedArrayElementType.Uint16, arguments.At(1));
}
private JsValue SetUint32(JsValue thisObject, JsCallArguments arguments)
{
return SetViewValue(thisObject, arguments.At(0), arguments.At(2, JsBoolean.False), TypedArrayElementType.Uint32, arguments.At(1));
}
///
/// https://tc39.es/ecma262/#sec-getviewvalue
///
private JsValue GetViewValue(
JsValue view,
JsValue requestIndex,
JsValue isLittleEndian,
TypedArrayElementType type)
{
if (view is not JsDataView dataView)
{
Throw.TypeError(_realm, "Method called on incompatible receiver " + view);
return Undefined;
}
var getIndex = (int) TypeConverter.ToIndex(_realm, requestIndex);
var isLittleEndianBoolean = TypeConverter.ToBoolean(isLittleEndian);
var buffer = dataView._viewedArrayBuffer!;
buffer.AssertNotDetached();
var viewOffset = dataView._byteOffset;
var viewRecord = MakeDataViewWithBufferWitnessRecord(dataView, ArrayBufferOrder.Unordered);
if (viewRecord.IsViewOutOfBounds)
{
Throw.TypeError(_realm, "Offset is outside the bounds of the DataView");
}
var viewSize = viewRecord.ViewByteLength;
var elementSize = type.GetElementSize();
if (getIndex + elementSize > viewSize)
{
Throw.RangeError(_realm, "Offset is outside the bounds of the DataView");
}
var bufferIndex = (int) (getIndex + viewOffset);
return buffer.GetValueFromBuffer(bufferIndex, type, isTypedArray: false, ArrayBufferOrder.Unordered, isLittleEndianBoolean).ToJsValue();
}
internal readonly record struct DataViewWithBufferWitnessRecord(JsDataView Object, int CachedBufferByteLength)
{
///
/// https://tc39.es/ecma262/#sec-isviewoutofbounds
///
public bool IsViewOutOfBounds
{
get
{
var view = Object;
var bufferByteLength = CachedBufferByteLength;
if (bufferByteLength == -1)
{
return true;
}
var byteOffsetStart = view._byteOffset;
long byteOffsetEnd;
if (view._byteLength == JsTypedArray.LengthAuto)
{
byteOffsetEnd = bufferByteLength;
}
else
{
byteOffsetEnd = byteOffsetStart + view._byteLength;
}
if (byteOffsetStart > bufferByteLength || byteOffsetEnd > bufferByteLength)
{
return true;
}
return false;
}
}
///
/// https://tc39.es/ecma262/#sec-getviewbytelength
///
public long ViewByteLength
{
get
{
var view = Object;
if (view._byteLength != JsTypedArray.LengthAuto)
{
return view._byteLength;
}
var byteOffset = view._byteOffset;
var byteLength = CachedBufferByteLength;
return byteLength - byteOffset;
}
}
}
///
/// https://tc39.es/ecma262/#sec-makedataviewwithbufferwitnessrecord
///
private static DataViewWithBufferWitnessRecord MakeDataViewWithBufferWitnessRecord(JsDataView obj, ArrayBufferOrder order)
{
var buffer = obj._viewedArrayBuffer;
int byteLength;
if (buffer?.IsDetachedBuffer == true)
{
byteLength = -1;
}
else
{
byteLength = IntrinsicTypedArrayPrototype.ArrayBufferByteLength(buffer!, order);
}
return new DataViewWithBufferWitnessRecord(obj, byteLength);
}
///
/// https://tc39.es/ecma262/#sec-setviewvalue
///
private JsValue SetViewValue(
JsValue view,
JsValue requestIndex,
JsValue isLittleEndian,
TypedArrayElementType type,
JsValue value)
{
var dataView = view as JsDataView;
if (dataView is null)
{
Throw.TypeError(_realm, "Method called on incompatible receiver " + view);
}
var getIndex = TypeConverter.ToIndex(_realm, requestIndex);
TypedArrayValue numberValue;
if (type.IsBigIntElementType())
{
numberValue = TypeConverter.ToBigInt(value);
}
else
{
numberValue = TypeConverter.ToNumber(value);
}
var isLittleEndianBoolean = TypeConverter.ToBoolean(isLittleEndian);
var buffer = dataView._viewedArrayBuffer!;
buffer.AssertNotDetached();
var viewOffset = dataView._byteOffset;
var viewRecord = MakeDataViewWithBufferWitnessRecord(dataView, ArrayBufferOrder.Unordered);
if (viewRecord.IsViewOutOfBounds)
{
Throw.TypeError(_realm, "Offset is outside the bounds of the DataView");
}
var viewSize = viewRecord.ViewByteLength;
var elementSize = type.GetElementSize();
if (getIndex + elementSize > viewSize)
{
Throw.RangeError(_realm, "Offset is outside the bounds of the DataView");
}
var bufferIndex = (int) (getIndex + viewOffset);
buffer.SetValueInBuffer(bufferIndex, type, numberValue, false, ArrayBufferOrder.Unordered, isLittleEndianBoolean);
return Undefined;
}
}