23.2.3 %TypedArray% Prototype オブジェクトのプロパティ
%TypedArray% prototype オブジェクトは:
- 値が %Object.prototype% である [[Prototype]] 内部スロットを持ちます。
- %TypedArray.prototype% です。
- 通常オブジェクトです。
- [[ViewedArrayBuffer]] または TypedArray インスタンスオブジェクトに固有のその他の内部スロットを持ちません。
23.2.3.1 %TypedArray%.prototype.at ( index )
- obj を this 値とする。
- taRecord を ? ValidateTypedArray(obj, seq-cst) とする。
- length を TypedArrayLength(taRecord) とする。
- k を ? ToAbsoluteIndex(index, length) とする。
- k < 0 または k ≥ length である場合、undefined を返す。
- TypedArrayGetElement(obj, 𝔽(k)) を返す。
23.2.3.2 get %TypedArray%.prototype.buffer
%TypedArray%.prototype.buffer は、set アクセサー関数が undefined であるアクセサープロパティです。その get アクセサー関数は、呼び出されたときに次の手順を実行します。
- obj を this 値とする。
- ? RequireInternalSlot(obj, [[TypedArrayName]]) を実行する。
- 表明: obj は [[ViewedArrayBuffer]] 内部スロットを持つ。
- buffer を obj.[[ViewedArrayBuffer]] とする。
- buffer を返す。
23.2.3.3 get %TypedArray%.prototype.byteLength
%TypedArray%.prototype.byteLength は、set アクセサー関数が undefined であるアクセサープロパティです。その get アクセサー関数は、呼び出されたときに次の手順を実行します。
- obj を this 値とする。
- ? RequireInternalSlot(obj, [[TypedArrayName]]) を実行する。
- 表明: obj は [[ViewedArrayBuffer]] 内部スロットを持つ。
- taRecord を MakeTypedArrayWithBufferWitnessRecord(obj, seq-cst) とする。
- IsTypedArrayOutOfBounds(taRecord) が true である場合、+0𝔽 を返す。
- size を TypedArrayByteLength(taRecord) とする。
- 𝔽(size) を返す。
23.2.3.4 get %TypedArray%.prototype.byteOffset
%TypedArray%.prototype.byteOffset は、set アクセサー関数が undefined であるアクセサープロパティです。その get アクセサー関数は、呼び出されたときに次の手順を実行します。
- obj を this 値とする。
- ? RequireInternalSlot(obj, [[TypedArrayName]]) を実行する。
- 表明: obj は [[ViewedArrayBuffer]] 内部スロットを持つ。
- taRecord を MakeTypedArrayWithBufferWitnessRecord(obj, seq-cst) とする。
- IsTypedArrayOutOfBounds(taRecord) が true である場合、+0𝔽 を返す。
- offset を obj.[[ByteOffset]] とする。
- 𝔽(offset) を返す。
23.2.3.5 %TypedArray%.prototype.constructor
%TypedArray%.prototype.constructor の初期値は %TypedArray% です。
23.2.3.6 %TypedArray%.prototype.copyWithin ( target, start [ , end ] )
このメソッドの引数の解釈と使用法は、23.1.3.4 で定義される Array.prototype.copyWithin と同じです。
このメソッドは呼び出されたとき、次の手順を実行します。
- obj を this 値とする。
- taRecord を ? ValidateTypedArray(obj, seq-cst) とする。
- length を TypedArrayLength(taRecord) とする。
- targetIndex を ? ToClampedIndex(target, length) とする。
- startIndex を ? ToClampedIndex(start, length) とする。
- end が undefined である場合、endIndex を length とする。そうでない場合、endIndex を ? ToClampedIndex(end, length) とする。
- count を min(endIndex - startIndex, length - targetIndex) とする。
- count > 0 である場合、
- 注記: コピーは、元データのビットレベルのエンコーディングを保持する方法で実行されなければならない。
- buffer を obj.[[ViewedArrayBuffer]] とする。
- taRecord を ? ValidateTypedArrayBounds(obj, seq-cst) に設定する。
- length を TypedArrayLength(taRecord) に設定する。
- 注記: 上記手順の副作用によって obj のサイズが縮小されている場合があり、その場合、依然として適用可能な最長の接頭部分でコピーを続行するべきである。
- count を min(count, length - startIndex, length - targetIndex) に設定する。
- elementSize を TypedArrayElementSize(obj) とする。
- byteOffset を obj.[[ByteOffset]] とする。
- toByteIndex を (targetIndex × elementSize) + byteOffset とする。
- fromByteIndex を (startIndex × elementSize) + byteOffset とする。
- countBytes を count × elementSize とする。
- fromByteIndex < toByteIndex かつ toByteIndex < fromByteIndex + countBytes である場合、
- direction を -1 とする。
- fromByteIndex を fromByteIndex + countBytes - 1 に設定する。
- toByteIndex を toByteIndex + countBytes - 1 に設定する。
- そうでない場合、
- direction を 1 とする。
- countBytes > 0 の間、次を繰り返す。
- 表明: fromByteIndex ≥ 0 かつ toByteIndex ≥ 0。
- value を GetValueFromBuffer(buffer, fromByteIndex, uint8, true, unordered) とする。
- SetValueInBuffer(buffer, toByteIndex, uint8, value, true, unordered) を実行する。
- fromByteIndex を fromByteIndex + direction に設定する。
- toByteIndex を toByteIndex + direction に設定する。
- countBytes を countBytes - 1 に設定する。
- obj を返す。
23.2.3.7 %TypedArray%.prototype.entries ( )
このメソッドは呼び出されたとき、次の手順を実行します。
- obj を this 値とする。
- ? ValidateTypedArray(obj, seq-cst) を実行する。
- CreateArrayIterator(obj, key+value) を返す。
23.2.3.8 %TypedArray%.prototype.every ( callback [ , thisArg ] )
このメソッドの引数の解釈と使用法は、23.1.3.6 で定義される Array.prototype.every と同じです。
このメソッドは呼び出されたとき、次の手順を実行します。
- obj を this 値とする。
- taRecord を ? ValidateTypedArray(obj, seq-cst) とする。
- length を TypedArrayLength(taRecord) とする。
- IsCallable(callback) が false である場合、TypeError 例外をスローする。
- k を 0 とする。
- k < length の間、次を繰り返す。
- kValue を TypedArrayGetElement(obj, 𝔽(k)) とする。
- testResult を ToBoolean(? Call(callback, thisArg, « kValue, 𝔽(k), obj »)) とする。
- testResult が false である場合、false を返す。
- k を k + 1 に設定する。
- true を返す。
このメソッドは汎用ではありません。this 値は [[TypedArrayName]] 内部スロットを持つオブジェクトでなければなりません。
23.2.3.9 %TypedArray%.prototype.fill ( value [ , start [ , end ] ] )
このメソッドの引数の解釈と使用法は、23.1.3.7 で定義される Array.prototype.fill と同じです。
このメソッドは呼び出されたとき、次の手順を実行します。
- obj を this 値とする。
- taRecord を ? ValidateTypedArray(obj, seq-cst) とする。
- length を TypedArrayLength(taRecord) とする。
- obj.[[ContentType]] が bigint である場合、value を ? ToBigInt(value) に設定する。
- そうでない場合、value を ? ToNumber(value) に設定する。
- startIndex を ? ToClampedIndex(start, length) とする。
- end が undefined である場合、endIndex を length とする。そうでない場合、endIndex を ? ToClampedIndex(end, length) とする。
- taRecord を ? ValidateTypedArrayBounds(obj, seq-cst) に設定する。
- length を TypedArrayLength(taRecord) に設定する。
- endIndex を min(endIndex, length) に設定する。
- k を startIndex とする。
- k < endIndex の間、次を繰り返す。
- ! TypedArraySetElement(obj, 𝔽(k), value) を実行する。
- k を k + 1 に設定する。
- obj を返す。
23.2.3.10 %TypedArray%.prototype.filter ( callback [ , thisArg ] )
このメソッドの引数の解釈と使用法は、23.1.3.8 で定義される Array.prototype.filter と同じです。
このメソッドは呼び出されたとき、次の手順を実行します。
- obj を this 値とする。
- taRecord を ? ValidateTypedArray(obj, seq-cst) とする。
- length を TypedArrayLength(taRecord) とする。
- IsCallable(callback) が false の場合、TypeError 例外を投げる。
- kept を新しい空の List とする。
- captured を 0 とする。
- k を 0 とする。
- k < length の間、以下を繰り返す。
- kValue を TypedArrayGetElement(obj, 𝔽(k)) とする。
- selected を ToBoolean(? Call(callback, thisArg, « kValue, 𝔽(k), obj »)) とする。
- selected が true の場合、
- kValue を kept に追加する。
- captured を captured + 1 に設定する。
- k を k + 1 に設定する。
- result を ? TypedArraySpeciesCreate(obj, « 𝔽(captured) ») とする。
- n を 0 とする。
- kept の各要素 element について、以下を行う。
- 注: callback の呼び出しによって obj の基になるバッファーがデタッチまたは縮小された場合、element は undefined となることがある。
- ? TypedArraySetElement(result, 𝔽(n), element) を実行する。
- n を n + 1 に設定する。
- result を返す。
このメソッドは汎用ではありません。this 値は [[TypedArrayName]] 内部スロットを持つオブジェクトでなければなりません。
23.2.3.11 %TypedArray%.prototype.find ( predicate [ , thisArg ] )
このメソッドの引数の解釈と使用法は、23.1.3.9 で定義される Array.prototype.find と同じです。
このメソッドは呼び出されたとき、次の手順を実行します。
- obj を this 値とする。
- taRecord を ? ValidateTypedArray(obj, seq-cst) とする。
- length を TypedArrayLength(taRecord) とする。
- findRecord を ? FindViaPredicate(obj, length, ascending, predicate, thisArg) とする。
- findRecord.[[Value]] を返す。
このメソッドは汎用ではありません。this 値は [[TypedArrayName]] 内部スロットを持つオブジェクトでなければなりません。
23.2.3.12 %TypedArray%.prototype.findIndex ( predicate [ , thisArg ] )
このメソッドの引数の解釈と使用法は、23.1.3.10 で定義される Array.prototype.findIndex と同じです。
このメソッドは呼び出されたとき、次の手順を実行します。
- obj を this 値とする。
- taRecord を ? ValidateTypedArray(obj, seq-cst) とする。
- length を TypedArrayLength(taRecord) とする。
- findRecord を ? FindViaPredicate(obj, length, ascending, predicate, thisArg) とする。
- findRecord.[[Index]] を返す。
このメソッドは汎用ではありません。this 値は [[TypedArrayName]] 内部スロットを持つオブジェクトでなければなりません。
23.2.3.13 %TypedArray%.prototype.findLast ( predicate [ , thisArg ] )
このメソッドの引数の解釈と使用法は、23.1.3.11 で定義される Array.prototype.findLast と同じです。
このメソッドは呼び出されたとき、次の手順を実行します。
- obj を this 値とする。
- taRecord を ? ValidateTypedArray(obj, seq-cst) とする。
- length を TypedArrayLength(taRecord) とする。
- findRecord を ? FindViaPredicate(obj, length, descending, predicate, thisArg) とする。
- findRecord.[[Value]] を返す。
このメソッドは汎用ではありません。this 値は [[TypedArrayName]] 内部スロットを持つオブジェクトでなければなりません。
23.2.3.14 %TypedArray%.prototype.findLastIndex ( predicate [ , thisArg ] )
このメソッドの引数の解釈と使用法は、23.1.3.12 で定義される Array.prototype.findLastIndex と同じです。
このメソッドは呼び出されたとき、次の手順を実行します。
- obj を this 値とする。
- taRecord を ? ValidateTypedArray(obj, seq-cst) とする。
- length を TypedArrayLength(taRecord) とする。
- findRecord を ? FindViaPredicate(obj, length, descending, predicate, thisArg) とする。
- findRecord.[[Index]] を返す。
このメソッドは汎用ではありません。this 値は [[TypedArrayName]] 内部スロットを持つオブジェクトでなければなりません。
23.2.3.15 %TypedArray%.prototype.forEach ( callback [ , thisArg ] )
このメソッドの引数の解釈と使用法は、23.1.3.15 で定義される Array.prototype.forEach と同じです。
このメソッドは呼び出されたとき、次の手順を実行します。
- obj を this 値とする。
- taRecord を ? ValidateTypedArray(obj, seq-cst) とする。
- length を TypedArrayLength(taRecord) とする。
- IsCallable(callback) が false である場合、TypeError 例外をスローする。
- k を 0 とする。
- k < length の間、次を繰り返す。
- kValue を TypedArrayGetElement(obj, 𝔽(k)) とする。
- ? Call(callback, thisArg, « kValue, 𝔽(k), obj ») を実行する。
- k を k + 1 に設定する。
- undefined を返す。
このメソッドは汎用ではありません。this 値は [[TypedArrayName]] 内部スロットを持つオブジェクトでなければなりません。
23.2.3.16 %TypedArray%.prototype.includes ( searchElement [ , fromIndex ] )
このメソッドの引数の解釈と使用法は、23.1.3.16 で定義される Array.prototype.includes と同じです。
このメソッドは呼び出されたとき、次の手順を実行します。
- obj を this 値とする。
- taRecord を ? ValidateTypedArray(obj, seq-cst) とする。
- length を TypedArrayLength(taRecord) とする。
- length = 0 である場合、false を返す。
- k を ? ToClampedIndex(fromIndex, length) とする。
- k < length の間、次を繰り返す。
- elementK を TypedArrayGetElement(obj, 𝔽(k)) とする。
- SameValueZero(searchElement, elementK) が true である場合、true を返す。
- k を k + 1 に設定する。
- false を返す。
このメソッドは汎用ではありません。this 値は [[TypedArrayName]] 内部スロットを持つオブジェクトでなければなりません。
23.2.3.17 %TypedArray%.prototype.indexOf ( searchElement [ , fromIndex ] )
このメソッドの引数の解釈と使用法は、23.1.3.17 で定義される Array.prototype.indexOf と同じです。
このメソッドは呼び出されたとき、次の手順を実行します。
- obj を this 値とする。
- taRecord を ? ValidateTypedArray(obj, seq-cst) とする。
- length を TypedArrayLength(taRecord) とする。
- length = 0 である場合、-1𝔽 を返す。
- k を ? ToClampedIndex(fromIndex, length) とする。
- k < length の間、次を繰り返す。
- propertyKey を ! ToString(𝔽(k)) とする。
- kPresent を ! HasProperty(obj, propertyKey) とする。
- kPresent が true である場合、
- elementK を TypedArrayGetElement(obj, 𝔽(k)) とする。
- IsStrictlyEqual(searchElement, elementK) が true である場合、𝔽(k) を返す。
- k を k + 1 に設定する。
- -1𝔽 を返す。
このメソッドは汎用ではありません。this 値は [[TypedArrayName]] 内部スロットを持つオブジェクトでなければなりません。
23.2.3.18 %TypedArray%.prototype.join ( separator )
このメソッドの引数の解釈と使用法は、23.1.3.18 で定義される Array.prototype.join と同じです。
このメソッドは呼び出されたとき、次の手順を実行します。
- obj を this 値とする。
- taRecord を ? ValidateTypedArray(obj, seq-cst) とする。
- length を TypedArrayLength(taRecord) とする。
- separator が undefined ならば、separatorString を "," とする; そうでなければ、separatorString を ? ToString(separator) とする。
- ? JoinIndexedProperties(obj, length, separatorString) を返す。
このメソッドは汎用ではありません。this 値は [[TypedArrayName]] 内部スロットを持つオブジェクトでなければなりません。
23.2.3.19 %TypedArray%.prototype.keys ( )
このメソッドは呼び出されたとき、次の手順を実行します。
- obj を this 値とする。
- ? ValidateTypedArray(obj, seq-cst) を実行する。
- CreateArrayIterator(obj, key) を返す。
23.2.3.20 %TypedArray%.prototype.lastIndexOf ( searchElement [ , fromIndex ] )
このメソッドの引数の解釈と使用法は、23.1.3.20 で定義される Array.prototype.lastIndexOf と同じです。
このメソッドは呼び出されたとき、次の手順を実行します。
- obj を this 値とする。
- taRecord を ? ValidateTypedArray(obj, seq-cst) とする。
- length を TypedArrayLength(taRecord) とする。
- length = 0 である場合、-1𝔽 を返す。
- fromIndex が存在しない場合、k を length - 1 とする。そうでない場合、k を min(? ToAbsoluteIndex(fromIndex, length), length - 1) とする。
- k ≥ 0 の間、次を繰り返す。
- propertyKey を ! ToString(𝔽(k)) とする。
- kPresent を ! HasProperty(obj, propertyKey) とする。
- kPresent が true である場合、
- elementK を TypedArrayGetElement(obj, 𝔽(k)) とする。
- IsStrictlyEqual(searchElement, elementK) が true である場合、𝔽(k) を返す。
- k を k - 1 に設定する。
- -1𝔽 を返す。
このメソッドは汎用ではありません。this 値は [[TypedArrayName]] 内部スロットを持つオブジェクトでなければなりません。
23.2.3.21 get %TypedArray%.prototype.length
%TypedArray%.prototype.length は、set アクセサー関数が undefined であるアクセサープロパティです。その get アクセサー関数は、呼び出されたときに次の手順を実行します。
- obj を this 値とする。
- ? RequireInternalSlot(obj, [[TypedArrayName]]) を実行する。
- 表明: obj は [[ViewedArrayBuffer]] および [[ArrayLength]] 内部スロットを持つ。
- taRecord を MakeTypedArrayWithBufferWitnessRecord(obj, seq-cst) とする。
- IsTypedArrayOutOfBounds(taRecord) が true である場合、+0𝔽 を返す。
- length を TypedArrayLength(taRecord) とする。
- 𝔽(length) を返す。
この関数は汎用ではありません。this 値は [[TypedArrayName]] 内部スロットを持つオブジェクトでなければなりません。
23.2.3.22 %TypedArray%.prototype.map ( callback [ , thisArg ] )
このメソッドの引数の解釈と使用法は、23.1.3.21 で定義される Array.prototype.map と同じです。
このメソッドは呼び出されたとき、次の手順を実行します。
- obj を this 値とする。
- taRecord を ? ValidateTypedArray(obj, seq-cst) とする。
- length を TypedArrayLength(taRecord) とする。
- IsCallable(callback) が false である場合、TypeError 例外をスローする。
- result を ? TypedArraySpeciesCreate(obj, « 𝔽(length) ») とする。
- k を 0 とする。
- k < length の間、次を繰り返す。
- kValue を TypedArrayGetElement(obj, 𝔽(k)) とする。
- mappedValue を ? Call(callback, thisArg, « kValue, 𝔽(k), obj ») とする。
- ? TypedArraySetElement(result, 𝔽(k), mappedValue) を実行する。
- k を k + 1 に設定する。
- result を返す。
このメソッドは汎用ではありません。this 値は [[TypedArrayName]] 内部スロットを持つオブジェクトでなければなりません。
23.2.3.23 %TypedArray%.prototype.reduce ( callback [ , initialValue ] )
このメソッドの引数の解釈と使用法は、23.1.3.24 で定義される Array.prototype.reduce と同じです。
このメソッドは呼び出されたとき、次の手順を実行します。
- obj を this 値とする。
- taRecord を ? ValidateTypedArray(obj, seq-cst) とする。
- length を TypedArrayLength(taRecord) とする。
- IsCallable(callback) が false である場合、TypeError 例外をスローする。
- length = 0 かつ initialValue が存在しない場合、TypeError 例外をスローする。
- k を 0 とする。
- accumulator を undefined とする。
- initialValue が存在する場合、
- accumulator を initialValue に設定する。
- そうでない場合、
- accumulator を TypedArrayGetElement(obj, 𝔽(k)) に設定する。
- k を k + 1 に設定する。
- k < length の間、次を繰り返す。
- kValue を TypedArrayGetElement(obj, 𝔽(k)) とする。
- accumulator を ? Call(callback, undefined, « accumulator, kValue, 𝔽(k), obj ») に設定する。
- k を k + 1 に設定する。
- accumulator を返す。
このメソッドは汎用ではありません。this 値は [[TypedArrayName]] 内部スロットを持つオブジェクトでなければなりません。
23.2.3.24 %TypedArray%.prototype.reduceRight ( callback [ , initialValue ] )
このメソッドの引数の解釈と使用法は、23.1.3.25 で定義される Array.prototype.reduceRight と同じです。
このメソッドは呼び出されたとき、次の手順を実行します。
- obj を this 値とする。
- taRecord を ? ValidateTypedArray(obj, seq-cst) とする。
- length を TypedArrayLength(taRecord) とする。
- IsCallable(callback) が false である場合、TypeError 例外をスローする。
- length = 0 かつ initialValue が存在しない場合、TypeError 例外をスローする。
- k を length - 1 とする。
- accumulator を undefined とする。
- initialValue が存在する場合、
- accumulator を initialValue に設定する。
- そうでない場合、
- accumulator を TypedArrayGetElement(obj, 𝔽(k)) に設定する。
- k を k - 1 に設定する。
- k ≥ 0 の間、次を繰り返す。
- kValue を TypedArrayGetElement(obj, 𝔽(k)) とする。
- accumulator を ? Call(callback, undefined, « accumulator, kValue, 𝔽(k), obj ») に設定する。
- k を k - 1 に設定する。
- accumulator を返す。
このメソッドは汎用ではありません。this 値は [[TypedArrayName]] 内部スロットを持つオブジェクトでなければなりません。
23.2.3.25 %TypedArray%.prototype.reverse ( )
このメソッドの引数の解釈と使用法は、23.1.3.26 で定義される Array.prototype.reverse と同じです。
このメソッドは呼び出されたとき、次の手順を実行します。
- obj を this 値とする。
- taRecord を ? ValidateTypedArray(obj, seq-cst) とする。
- length を TypedArrayLength(taRecord) とする。
- middle を floor(length / 2) とする。
- lower を 0 とする。
- lower ≠ middle の間、次を繰り返す。
- upper を length - lower - 1 とする。
- lowerValue を TypedArrayGetElement(obj, 𝔽(lower)) とする。
- upperValue を TypedArrayGetElement(obj, 𝔽(upper)) とする。
- ! TypedArraySetElement(obj, 𝔽(lower), upperValue) を実行する。
- ! TypedArraySetElement(obj, 𝔽(upper), lowerValue) を実行する。
- lower を lower + 1 に設定する。
- obj を返す。
このメソッドは汎用ではありません。this 値は [[TypedArrayName]] 内部スロットを持つオブジェクトでなければなりません。
23.2.3.26 %TypedArray%.prototype.set ( source [ , offset ] )
このメソッドは、source から値を読み取り、この TypedArray 内に複数の値を設定します。詳細は source の型に基づいて異なります。省略可能な offset 値は、この TypedArray 内で値の書込みを開始する最初の要素インデックスを示します。省略された場合、0 であるとみなされます。
呼び出されたとき、次の手順を実行します。
- target を this 値とする。
- ? RequireInternalSlot(target, [[TypedArrayName]]) を実行する。
- 表明: target は [[ViewedArrayBuffer]] 内部スロットを持つ。
- targetOffset を ? ToIntegerOrInfinity(offset) とする。
- targetOffset < 0 である場合、RangeError 例外をスローする。
- source が [[TypedArrayName]] 内部スロットを持つ Object である場合、
- ? SetTypedArrayFromTypedArray(target, targetOffset, source) を実行する。
- そうでない場合、
- ? SetTypedArrayFromArrayLike(target, targetOffset, source) を実行する。
- undefined を返す。
このメソッドは汎用ではありません。this 値は [[TypedArrayName]] 内部スロットを持つオブジェクトでなければなりません。
23.2.3.26.1 SetTypedArrayFromArrayLike ( target, targetOffset, source )
抽象操作 SetTypedArrayFromArrayLike。引数 target (TypedArray)、targetOffset ((非負整数 または +∞)) および source (an ECMAScript language value, but not a TypedArray)。戻り値:(正常完了 (値:unused) または throw 完了)。 source から値を読み取り、インデックス targetOffset から開始して target 内に複数の値を設定します。 呼び出されると、次の手順を実行する。
- targetRecord を ? ValidateTypedArrayBounds(target, seq-cst) とする。
- targetLength を TypedArrayLength(targetRecord) とする。
- source を ? ToObject(source) に設定する。
- sourceLength を ? LengthOfArrayLike(source) とする。
- targetOffset = +∞ である場合、RangeError 例外をスローする。
- sourceLength + targetOffset > targetLength である場合、RangeError 例外をスローする。
- k を 0 とする。
- k < sourceLength の間、次を繰り返す。
- propertyKey を ! ToString(𝔽(k)) とする。
- value を ? Get(source, propertyKey) とする。
- targetIndex を 𝔽(targetOffset + k) とする。
- ? TypedArraySetElement(target, targetIndex, value) を実行する。
- k を k + 1 に設定する。
- unused を返す。
23.2.3.26.2 SetTypedArrayFromTypedArray ( target, targetOffset, source )
抽象操作 SetTypedArrayFromTypedArray。引数 target (TypedArray)、targetOffset ((非負整数 または +∞)) および source (TypedArray)。戻り値:(正常完了 (値:unused) または throw 完了)。 source から値を読み取り、インデックス targetOffset から開始して target 内に複数の値を設定します。 呼び出されると、次の手順を実行する。
- targetBuffer を target.[[ViewedArrayBuffer]] とする。
- targetRecord を ? ValidateTypedArrayBounds(target, seq-cst) とする。
- targetLength を TypedArrayLength(targetRecord) とする。
- sourceBuffer を source.[[ViewedArrayBuffer]] とする。
- sourceRecord を ? ValidateTypedArrayBounds(source, seq-cst) とする。
- sourceLength を TypedArrayLength(sourceRecord) とする。
- targetType を TypedArrayElementType(target) とする。
- targetElementSize を TypedArrayElementSize(target) とする。
- targetByteOffset を target.[[ByteOffset]] とする。
- sourceType を TypedArrayElementType(source) とする。
- sourceElementSize を TypedArrayElementSize(source) とする。
- sourceByteOffset を source.[[ByteOffset]] とする。
- targetOffset = +∞ である場合、RangeError 例外をスローする。
- sourceLength + targetOffset > targetLength である場合、RangeError 例外をスローする。
- target.[[ContentType]] が source.[[ContentType]] でない場合、TypeError 例外をスローする。
- IsSharedArrayBuffer(sourceBuffer) が true、IsSharedArrayBuffer(targetBuffer) が true、かつ sourceBuffer.[[ArrayBufferData]] が targetBuffer.[[ArrayBufferData]] である場合、sameSharedArrayBuffer を true とする。そうでない場合、sameSharedArrayBuffer を false とする。
- SameValue(sourceBuffer, targetBuffer) が true または sameSharedArrayBuffer が true である場合、
- sourceByteLength を TypedArrayByteLength(sourceRecord) とする。
- sourceBuffer を ? CloneArrayBuffer(sourceBuffer, sourceByteOffset, sourceByteLength) に設定する。
- sourceByteIndex を 0 とする。
- そうでない場合、
- sourceByteIndex を sourceByteOffset とする。
- targetByteIndex を (targetOffset × targetElementSize) + targetByteOffset とする。
- limit を targetByteIndex + (targetElementSize × sourceLength) とする。
- sourceType が targetType である場合、
- 注記: 転送は、元データのビットレベルのエンコーディングを保持する方法で実行されなければならない。
- targetByteIndex < limit の間、次を繰り返す。
- value を GetValueFromBuffer(sourceBuffer, sourceByteIndex, uint8, true, unordered) とする。
- SetValueInBuffer(targetBuffer, targetByteIndex, uint8, value, true, unordered) を実行する。
- sourceByteIndex を sourceByteIndex + 1 に設定する。
- targetByteIndex を targetByteIndex + 1 に設定する。
- そうでない場合、
- targetByteIndex < limit の間、次を繰り返す。
- value を GetValueFromBuffer(sourceBuffer, sourceByteIndex, sourceType, true, unordered) とする。
- SetValueInBuffer(targetBuffer, targetByteIndex, targetType, value, true, unordered) を実行する。
- sourceByteIndex を sourceByteIndex + sourceElementSize に設定する。
- targetByteIndex を targetByteIndex + targetElementSize に設定する。
- unused を返す。
23.2.3.27 %TypedArray%.prototype.slice ( start, end )
このメソッドの引数の解釈と使用法は、23.1.3.28 で定義される Array.prototype.slice と同じです。
このメソッドは呼び出されたとき、次の手順を実行します。
- obj を this 値とする。
- taRecord を ? ValidateTypedArray(obj, seq-cst) とする。
- sourceArrayLength を TypedArrayLength(taRecord) とする。
- startIndex を ? ToClampedIndex(start, sourceArrayLength) とする。
- end が undefined である場合、endIndex を sourceArrayLength とする。そうでない場合、endIndex を ? ToClampedIndex(end, sourceArrayLength) とする。
- countBytes を max(endIndex - startIndex, 0) とする。
- resultArray を ? TypedArraySpeciesCreate(obj, « 𝔽(countBytes) ») とする。
- countBytes > 0 である場合、
- taRecord を ? ValidateTypedArrayBounds(obj, seq-cst) に設定する。
- endIndex を min(endIndex, TypedArrayLength(taRecord)) に設定する。
- countBytes を max(endIndex - startIndex, 0) に設定する。
- sourceType を TypedArrayElementType(obj) とする。
- targetType を TypedArrayElementType(resultArray) とする。
- sourceType が targetType である場合、
- 注記: 転送は、元データのビットレベルのエンコーディングを保持する方法で実行されなければならない。
- sourceBuffer を obj.[[ViewedArrayBuffer]] とする。
- targetBuffer を resultArray.[[ViewedArrayBuffer]] とする。
- elementSize を TypedArrayElementSize(obj) とする。
- sourceByteOffset を obj.[[ByteOffset]] とする。
- sourceByteIndex を (startIndex × elementSize) + sourceByteOffset とする。
- targetByteIndex を resultArray.[[ByteOffset]] とする。
- endByteIndex を targetByteIndex + (countBytes × elementSize) とする。
- targetByteIndex < endByteIndex の間、次を繰り返す。
- value を GetValueFromBuffer(sourceBuffer, sourceByteIndex, uint8, true, unordered) とする。
- SetValueInBuffer(targetBuffer, targetByteIndex, uint8, value, true, unordered) を実行する。
- sourceByteIndex を sourceByteIndex + 1 に設定する。
- targetByteIndex を targetByteIndex + 1 に設定する。
- そうでない場合、
- n を 0 とする。
- k を startIndex とする。
- k < endIndex の間、次を繰り返す。
- kValue を TypedArrayGetElement(obj, 𝔽(k)) とする。
- ! TypedArraySetElement(resultArray, 𝔽(n), kValue) を実行する。
- k を k + 1 に設定する。
- n を n + 1 に設定する。
- resultArray を返す。
このメソッドは汎用ではありません。this 値は [[TypedArrayName]] 内部スロットを持つオブジェクトでなければなりません。
23.2.3.28 %TypedArray%.prototype.some ( callback [ , thisArg ] )
このメソッドの引数の解釈と使用法は、23.1.3.29 で定義される Array.prototype.some と同じです。
このメソッドは呼び出されたとき、次の手順を実行します。
- obj を this 値とする。
- taRecord を ? ValidateTypedArray(obj, seq-cst) とする。
- length を TypedArrayLength(taRecord) とする。
- IsCallable(callback) が false である場合、TypeError 例外をスローする。
- k を 0 とする。
- k < length の間、次を繰り返す。
- kValue を TypedArrayGetElement(obj, 𝔽(k)) とする。
- testResult を ToBoolean(? Call(callback, thisArg, « kValue, 𝔽(k), obj »)) とする。
- testResult が true である場合、true を返す。
- k を k + 1 に設定する。
- false を返す。
このメソッドは汎用ではありません。this 値は [[TypedArrayName]] 内部スロットを持つオブジェクトでなければなりません。
23.2.3.29 %TypedArray%.prototype.sort ( comparator )
これは個別のメソッドであり、以下で説明する点を除き、23.1.3.30 で定義される Array.prototype.sort と同じ要件を実装します。このメソッドの実装は、this 値が整数インデックス付きプロパティが疎でないオブジェクトであることを利用して最適化してもかまいません。comparator が undefined の場合、このアルゴリズムによってユーザーコードが実行されることはなく、その TypedArray の長さが減少することもありません。
このメソッドは汎用ではありません。this 値は [[TypedArrayName]] 内部スロットを持つオブジェクトでなければなりません。
呼び出されたとき、次の手順を実行します。
- comparator が undefined でなく、IsCallable(comparator) が false である場合、TypeError 例外をスローする。
- obj を this 値とする。
- taRecord を ? ValidateTypedArray(obj, seq-cst) とする。
- length を TypedArrayLength(taRecord) とする。
- 注記: 次の closure は 23.1.3.30 で使用される文字列比較ではなく、数値比較を実行する。
- sortCompare を、comparator を捕捉し、パラメーター (x, y) を持ち、呼び出されたときに次の手順を実行する新しい Abstract Closure とする。
- ? CompareTypedArrayElements(x, y, comparator) を返す。
- sortedList を ? SortIndexedProperties(obj, length, sortCompare, read-through-holes) とする。
- j を 0 とする。
- j < length の間、次を繰り返す。
- ! TypedArraySetElement(obj, 𝔽(j), sortedList[j]) を実行する。
- j を j + 1 に設定する。
- obj を返す。
注
NaN は常に他の任意の値より大きいものとして比較されるため(CompareTypedArrayElements を参照)、comparator が指定されていない場合、NaN プロパティ値は常に結果の末尾にソートされます。
23.2.3.30 %TypedArray%.prototype.subarray ( start, end )
デフォルトでは、このメソッドは、要素型がこの TypedArray の要素型であり、ArrayBuffer がこの TypedArray の ArrayBuffer であり、start(含む)から end(含まない)までの区間の要素を参照する新しい TypedArray を返します。start または end のいずれかが負である場合、配列の先頭からではなく、末尾からのインデックスを参照します。この TypedArray の "constructor" プロパティ、またはそのコンストラクターの %Symbol.species% プロパティを上書きすると、このメソッドの動作を変更できます。
呼び出されたとき、次の手順を実行します。
- obj を this 値とする。
- ? RequireInternalSlot(obj, [[TypedArrayName]]) を実行する。
- 表明: obj は [[ViewedArrayBuffer]] 内部スロットを持つ。
- buffer を obj.[[ViewedArrayBuffer]] とする。
- sourceRecord を MakeTypedArrayWithBufferWitnessRecord(obj, seq-cst) とする。
- IsTypedArrayOutOfBounds(sourceRecord) が true である場合、
- sourceLength を 0 とする。
- そうでない場合、
- sourceLength を TypedArrayLength(sourceRecord) とする。
- startIndex を ? ToClampedIndex(start, sourceLength) とする。
- elementSize を TypedArrayElementSize(obj) とする。
- sourceByteOffset を obj.[[ByteOffset]] とする。
- beginByteOffset を sourceByteOffset + (startIndex × elementSize) とする。
- obj.[[ArrayLength]] が auto であり、end が undefined である場合、
- ? TypedArraySpeciesCreate(obj, « buffer, 𝔽(beginByteOffset) ») を返す。
- end が undefined である場合、endIndex を sourceLength とする。そうでない場合、endIndex を ? ToClampedIndex(end, sourceLength) とする。
- newLength を max(endIndex - startIndex, 0) とする。
- ? TypedArraySpeciesCreate(obj, « buffer, 𝔽(beginByteOffset), 𝔽(newLength) ») を返す。
このメソッドは汎用ではありません。this 値は [[TypedArrayName]] 内部スロットを持つオブジェクトでなければなりません。
23.2.3.31 %TypedArray%.prototype.toLocaleString ( [ reserved1 [ , reserved2 ] ] )
ECMA-402 国際化 API を含む ECMAScript 実装は、ECMA-402 で規定されているとおりにこのメソッドを実装しなければならない。それ以外の場合は、このメソッドについて以下の仕様を使用する。
このメソッドの引数の解釈と使用方法は、Array.prototype.toLocaleString について 23.1.3.32で定義されているものと同じである。
このメソッドは、呼び出されたときに次の手順を実行する。
- obj を this 値とする。
- taRecord を ? ValidateTypedArray(obj, seq-cst) とする。
- length を TypedArrayLength(taRecord) とする。
- ? JoinIndexedProperties(obj, length, LocalizedListSeparator(), "toLocaleString") を返す。
23.2.3.32 %TypedArray%.prototype.toReversed ( )
このメソッドは呼び出されたとき、次の手順を実行します。
- obj を this 値とする。
- taRecord を ? ValidateTypedArray(obj, seq-cst) とする。
- length を TypedArrayLength(taRecord) とする。
- resultArray を ? TypedArrayCreateSameType(obj, length) とする。
- k を 0 とする。
- k < length の間、次を繰り返す。
- from を length - k - 1 とする。
- fromValue を TypedArrayGetElement(obj, 𝔽(from)) とする。
- ! TypedArraySetElement(resultArray, 𝔽(k), fromValue) を実行する。
- k を k + 1 に設定する。
- resultArray を返す。
23.2.3.33 %TypedArray%.prototype.toSorted ( comparator )
このメソッドは呼び出されたとき、次の手順を実行します。
- comparator が undefined でなく、IsCallable(comparator) が false である場合、TypeError 例外をスローする。
- obj を this 値とする。
- taRecord を ? ValidateTypedArray(obj, seq-cst) とする。
- length を TypedArrayLength(taRecord) とする。
- resultArray を ? TypedArrayCreateSameType(obj, length) とする。
- 注記: 次の closure は 23.1.3.34 で使用される文字列比較ではなく、数値比較を実行する。
- sortCompare を、comparator を捕捉し、パラメーター (x, y) を持ち、呼び出されたときに次の手順を実行する新しい Abstract Closure とする。
- ? CompareTypedArrayElements(x, y, comparator) を返す。
- sortedList を ? SortIndexedProperties(obj, length, sortCompare, read-through-holes) とする。
- j を 0 とする。
- j < length の間、次を繰り返す。
- ! TypedArraySetElement(resultArray, 𝔽(j), sortedList[j]) を実行する。
- j を j + 1 に設定する。
- resultArray を返す。
23.2.3.34 %TypedArray%.prototype.toString ( )
"toString" プロパティの初期値は、23.1.3.36 で定義される %Array.prototype.toString% です。
23.2.3.35 %TypedArray%.prototype.values ( )
このメソッドは呼び出されたとき、次の手順を実行します。
- obj を this 値とする。
- ? ValidateTypedArray(obj, seq-cst) を実行する。
- CreateArrayIterator(obj, value) を返す。
23.2.3.36 %TypedArray%.prototype.with ( index, value )
このメソッドは呼び出されたとき、次の手順を実行します。
- obj を this 値とする。
- taRecord を ? ValidateTypedArray(obj, seq-cst) とする。
- length を TypedArrayLength(taRecord) とする。
- actualIndex を ? ToAbsoluteIndex(index, length) とする。
- obj.[[ContentType]] が bigint の場合、numericValue を ? ToBigInt(value) とする。
- それ以外の場合、numericValue を ? ToNumber(value) とする。
- IsValidIntegerIndex(obj, 𝔽(actualIndex)) が false の場合、RangeError 例外を投げる。
- resultArray を ? TypedArrayCreateSameType(obj, length) とする。
- k を 0 とする。
- k < length の間、以下を繰り返す。
- k = actualIndex の場合、fromValue を numericValue とする。
- それ以外の場合、fromValue を TypedArrayGetElement(obj, 𝔽(k)) とする。
- 注: index または value が Number または BigInt への変換時にコードを実行するオブジェクトであり、そのコードによって obj の基になるバッファーが縮小された場合、fromValue は undefined となることがある。
- ? TypedArraySetElement(resultArray, 𝔽(k), fromValue) を実行する。
- k を k + 1 に設定する。
- resultArray を返す。
23.2.3.37 %TypedArray%.prototype [ %Symbol.iterator% ] ( )
%Symbol.iterator% プロパティの初期値は、23.2.3.35 で定義される %TypedArray.prototype.values% です。
23.2.3.38 get %TypedArray%.prototype [ %Symbol.toStringTag% ]
%TypedArray%.prototype[%Symbol.toStringTag%] は、set アクセサー関数が undefined であるアクセサープロパティです。その get アクセサー関数は、呼び出されたときに次の手順を実行します。
- obj を this 値とする。
- obj が Object でない場合、undefined を返す。
- obj が [[TypedArrayName]] 内部スロットを持たない場合、undefined を返す。
- name を obj.[[TypedArrayName]] とする。
- 表明: name は String である。
- name を返す。
このプロパティは属性 { [[Enumerable]]: false, [[Configurable]]: true } を持ちます。
この関数の "name" プロパティの初期値は "get [Symbol.toStringTag]" です。