[47] [DFN[[RUBYB[型付き配列]@en[typed array]]]]は、 [[バイナリーデータ]] ([[バイト列]]) を[[配列]]と似た [[API]] で扱うことができる [[JavaScript]] の[[クラス]]群です。 * 仕様書 [REFS[ - [69] [CITE[ECMAScript® 2018 Language Specification]] ([TIME[2017-06-14 04:16:40 +09:00]]) - [26] [CITE[Web IDL (Second Edition)]] ([TIME[2014-10-06 23:54:33 +09:00]] 版) - [39] [CITE[Web IDL (Second Edition)]] ([TIME[2014-10-06 23:54:33 +09:00]] 版) - [30] [CITE@en-GB-x-hixie[HTML Standard]] ([TIME[2014-05-23 20:05:44 +09:00]] 版) ]REFS] * 意味 [27] [DFN[[RUBYB[型付き配列型]@en[typed array type]]]]は、次の[[型]]です [SRC[>>26]]。 [FIG(short list)[ - [CODE(DOMi)@en[[[Int8Array]]]] - [CODE(DOMi)@en[[[Int16Array]]]] - [CODE(DOMi)@en[[[Int32Array]]]] - [CODE(DOMi)@en[[[Uint8Array]]]] - [CODE(DOMi)@en[[[Uint16Array]]]] - [CODE(DOMi)@en[[[Uint32Array]]]] - [CODE(DOMi)@en[[[Uint8ClampedArray]]]] - [CODE(DOMi)@en[[[Float32Array]]]] - [CODE(DOMi)@en[[[Float64Array]]]] ]FIG] [41] [DFN[[CODE(DOMi)@en[[[ArrayBufferView]]]]]] とは、[[型付き配列型]]または [CODE(IDL)@en[[[DataView]]]] をいいます [SRC[>>39, >>30]]。 [31] [CODE(IDL)@en[ArrayBufferView]] は、 [CODE(IDL)@en[BufferSource]] にも含まれています。 * 状態 [71] [[型付き配列]]は、 [F(ss)[TypedArrayName]] を持ちます。 値は種別 ([CODE[Int8Array]] など) を表しています。 [[JavaScript]] の[[仕様書]]上の[[オブジェクト]]の取り扱いにおいては、 この[[内部スロット]]の有無で[[型付き配列]]かどうかを判別しています。 [72] [CODE(JS)@en[ArrayBufferView]] は、 [F(ss)[ViewedArrayBuffer]] を持ちます。 値は [CODE(JS)@en[ArrayBuffer]] です。 [[構造化クローン]]や [CITE[Streams Standard]] の[[オブジェクト]]の取り扱いにおいては、 この[[内部スロット]]の有無で [CODE(IDL)@en[ArrayBufferView]] かどうかを判別しています。 ;; [29] ただの [CODE(IDL)@en[ArrayBuffer]] ではなく、 [CODE(IDL)@en[SharedArrayBuffer]] の場合もあります。 [74] [CODE(JS)@en[ArrayBufferView]] は、 [F(ss)[ByteOffset]] と [F(ss)[ByteLength]] を持ちます。それぞれ、 [F(ss)[ViewedArrayBuffer]] の[[バイト列]]における[[オフセット]]と[[長さ]]を表しています。 本 [CODE(JS)@en[ArrayBufferView]] は、[[バッファー]]上の該当範囲を表しています。 [75] [[型付き配列]]は、 [F(ss)[ArrayLength]] を持ちます。[[配列]]としての[[長さ]] ([[要素数]]) を表しています。各要素の[[バイト長]]が1バイトとは限らないので、 [F(ss)[ByteLength]] とは一致するとは限りません。 [73] これら[[内部スロット]]の値は、 [[コンストラクター]]内で設定され、以後変化することはありません。 * 文脈 [76] [CODE(JS)@en[ArrayBufferView]] の各[[クラス]]の[[インスタンス]]は、 [[コンストラクター]]により作成することができます。 [CODE(JS)@en[ArrayBuffer]]/[CODE(JS)@en[SharedArrayBuffer]] を指定した場合は、それが [F(ss)[ViewedArrayBuffer]] に設定されます。 それ以外の場合、新しい [CODE(DOMi)@en[ArrayBuffer]] が作成されます。 [40] [[型付き配列]]の [CODE(DOMm)@en[subarray]], [CODE(DOMm)@en[slice]], [CODE(DOMm)@en[filter]], [CODE(DOMm)@en[map]] 各[[メソッド]]は新しい[[型付き配列]]の[[インスタンス]]を作成します。 [CODE(DOMm)@en[subarray]] は同じ [CODE(JS)@en[ArrayBuffer]]/[CODE(JS)@en[SharedArrayBuffer]] を共有することになりますが、それ以外は新しい [CODE(DOMi)@en[ArrayBuffer]] を作成します。 [77] [CODE(JS)@en[ArrayBufferView]] の各[[クラス]]の[[インスタンス]]は、 [CODE(DOMi)@en[ReadableByteStreamController]] により (入力と同じ[[クラス]]のものが) 作成される場合があります。 [78] [CODE(JS)@en[Uint8Array]] の[[インスタンス]]は、 [CODE(JS)@en[ReadableByteStreamController]] により作成される場合があります。 [79] [CODE(DOMi)@en[Uint8ClampedArray]] の[[インスタンス]]は、 [CODE(DOMi)@en[ImageData]] [[オブジェクト]]の [CODE(DOMa)@en[data][ImageData]] [[IDL属性]]から得られます。 [81] [[fetch]] の処理も [CODE(DOMi)@en[ArrayBuffer]] や [CODE(DOMi)@en[Uint8Array]] を内部的に作成することがあります。 [45] [[構造化クローン]]により作成されることがあります。 * 比較 [83] [[TypedArray]] が[[等しいかどうか][等価性]]の[[比較]]は、 組み込みの方法はなく、 自分で実装するほかないようです。 * 変換 [84] [CODE[ArrayBuffer]] から [[TypedArray]] を得るには、 [[TypedArray]] の[[コンストラクター]]を使うといいです。 [EG[ [PRE(js code)[ typedArray = new Uint8Array (arrayBuffer); ]PRE] ]EG] [85] [[TypedArray]] から [CODE[Array]] を得るには、 [CODE[Array.from]] を使うといいです。 [EG[ [PRE(js code)[ array = Array.from (typedArray); ]PRE] ]EG] * 歴史 ** バイト列のない時代 [86] [[JavaScript]] には長らく[[バイト列]]専用の[[データ型]]がありませんでしたが、 [[バイト列]]を表す需要がないわけではありませんでした。 [[慣用句]]的な表現方法がいくつかありました。 - [87] [[JavaScript文字列]]: [[同型符号化]], [[同型復号]]を想定した [[Unicode文字列]]の [CODE[U+0000]] - [CODE[U+00FF]] で表す方法。 [CODE[btoa]], [CODE[atob]] が採用。 - [88] [CODE[Byte[__&&]&&__]]: [[int8]] の[[配列]]で表す方法。 [[Google Apps Script]] が採用。 - [89] [[パーセント符号化]], [[Base16]], [[Base64]] など: 直接操作しないで右から左に転送するだけのときに使われました。 ** [CODE(DOMi)@en[CanvasPixelArray]] [52] [[Web Applications 1.0]] は [CODE(HTMLe)@en[[[canvas]]]] の [CODE(DOMm)@en[[[getImageData]]]] と共に [DFN[[CODE(DOMi)@en[[[CanvasPixelArray]]]]]] を規定しました。 ** 型付き配列型 [21] [DFN[[CITE[ECMAScript Typed Array Specification]]]] ははじめ [[Khronos]] で標準化されました。 [REFS[ - [49] [CITE@en[ECMAScript Typed Array Specification]] ([TIME[2010-01-26 10:27:56 +09:00]] 版) - [1] [CITE@en[ECMAScript Typed Array Specification]] ([TIME[2010-03-04 09:01:49 +09:00]] 版) - [24] [CITE@en[Typed Array Specification]] ( ([TIME[2014-04-12 22:52:49 +09:00]] 版)) -- [34] [CITE@en[Typed Array Specification]] ( ([TIME[2014-04-12 22:52:49 +09:00]] 版)) -- [35] [CITE@en[Typed Array Specification]] ( ([TIME[2014-04-12 22:52:49 +09:00]] 版)) - [2] [CITE@en[Binary - CommonJS Spec Wiki]] ([TIME[2010-05-14 04:12:31 +09:00]] 版) - [3] [CITE[IRC logs: freenode / #whatwg / 20100625]] ([TIME[2010-06-29 00:39:18 +09:00]] 版) - [4] [CITE[IRC logs: freenode / #whatwg / 20100625]] ([TIME[2010-06-29 00:39:18 +09:00]] 版) - [5] [CITE[IRC logs: freenode / #whatwg / 20101212]] ( ([TIME[2011-01-03 18:17:01 +09:00]] 版)) - [6] [CITE[IRC logs: freenode / #whatwg / 20110212]] ( ([TIME[2011-03-22 22:45:03 +09:00]] 版)) - [7] [CITE['''['''whatwg''']''' ArrayBuffer and the structured clone algorithm]] ([TIME[2011-05-10 12:49:48 +09:00]] 版) - [8] [CITE[IRC logs: freenode / #whatwg / 20110525]] ( ([TIME[2011-05-28 03:13:09 +09:00]] 版)) - [9] [CITE[IRC logs: freenode / #whatwg / 20120121]] ( ([TIME[2012-01-22 22:55:46 +09:00]] 版)) - [10] [CITE[''''''[''''''whatwg'''''']'''''' API for encoding/decoding ArrayBuffers into text]] ( ([TIME[2012-03-17 12:12:10 +09:00]] 版)) - [11] [CITE[''''''[''''''whatwg'''''']'''''' API for encoding/decoding ArrayBuffers into text]] ( ([TIME[2012-03-17 12:12:44 +09:00]] 版)) - [12] [CITE[IRC logs: freenode / #whatwg / 20120327]] ( ([TIME[2012-04-09 21:35:50 +09:00]] 版)) - [13] [CITE[IRC logs: freenode / #whatwg / 20120328]] ( ([TIME[2012-04-09 21:56:14 +09:00]] 版)) - [14] [CITE[IRC logs: freenode / #whatwg / 20120329]] ( ([TIME[2012-04-09 23:38:43 +09:00]] 版)) - [15] [CITE@en[Web Applications 1.0 r7085 You send ArrayBufferViews, not ArrayBuffers.]] ( ([TIME[2012-05-03 05:17:00 +09:00]] 版)) - [16] [CITE@en[Web Applications 1.0 r7203 Four browser vendors have told me they don't want to drop this, so yeah, I'm putting it back. Sorry Anne. :-)]] ( ([TIME[2012-07-26 04:11:00 +09:00]] 版)) - [17] [CITE[IRC logs: freenode / #whatwg / 20130926]] ( ([TIME[2013-09-27 17:31:03 +09:00]] 版)) ]REFS] [23] [CODE(HTMLe)@en[[[canvas]]]] [[要素]]の [CODE(DOMi)@en[[[CanvasPixelArray]]]] は、2011年に [CODE(DOMi)@en[[[Uint8ClampedArray]]]] に変更されています。 [REFS[ - [50] [CITE[IRC logs: freenode / #whatwg / 20100203]] ([TIME[2010-02-06 01:45:27 +09:00]] 版) - [51] [CITE@en[Web Applications 1.0 r6559 Kill CanvasPixelArray in favour of the Typed Array stuff.]] ( ([TIME[2011-09-22 07:58:00 +09:00]] 版)) ]REFS] @@ [54] [[エンディアン]]問題 ** ES6 への統合 [22] その後 [[TypedArray]] は [[ES6]] に取り込まれました。 [53] [[Web IDL]] でも[[型付き配列型]]その他を扱うための[[データ型]]が追加されました。 [REFS[ - [18] [CITE@en-GB[ECMAScript Language Specification ECMA-262 6th Edition – DRAFT]] ( ([TIME[2014-01-24 00:08:47 +09:00]] 版)) - [32] [CITE@en[Web Applications 1.0 r7972 Integrate ArrayBuffer structured cloning]] ( ([TIME[2013-06-13 08:46:00 +09:00]] 版)) - [33] [CITE@en[HTML Standard Tracker]] ( ([TIME[2014-05-16 03:15:32 +09:00]] 版)) ]REFS] [REFS[ - [19] [CITE@en[Web Applications 1.0 r8454 First hack attempt at converting from referring to the old TypedArray spec to referring to the JS spec's version. I couldn't work out how to actually do a good job of referring to all the JS algorithms, so please file bugs with proposed replacement text for anything that's poorly done.]] ( ([TIME[2014-02-04 08:16:00 +09:00]] 版)) - [20] [CITE[IRC logs: freenode / #whatwg / 20140203]] ( ([TIME[2014-02-05 00:12:34 +09:00]] 版)) ]REFS] [REFS[ - [25] [CITE@en[Bug 23369 – Provide hooks for Typed Arrays (ArrayBuffer and friends)]] ( ([TIME[2014-06-10 12:18:10 +09:00]] 版)) - [28] [CITE@en[Add types for ArrayBuffer, DataView and typed array objects. · 631316b · heycam/webidl]] ([TIME[2014-10-10 08:07:12 +09:00]] 版) ]REFS] [REFS[ - [36] [CITE@en[Add an ArrayBufferData typedef. · 760fa16 · heycam/webidl]] ( ([TIME[2014-09-25 02:42:46 +09:00]] 版)) ]REFS] [38] >>37 で[[バッファー源型]]が導入されました。また [[HTML Standard]] にあった [CODE(IDL)@en[[[ArrayBufferView]]]] の定義が [[Web IDL]] に含まれるようになりました。 旧 [CODE(IDL)@en[[[ArrayBufferData]]]] は [CODE(IDL)@en[[[BufferSource]]]] に改称されました。 [REFS[ - [37] [CITE@en[Add types for ArrayBuffer, DataView and typed array objects. · 631316b · heycam/webidl]] ([TIME[2014-10-10 08:11:57 +09:00]] 版) - [42] [CITE@en[Recommend BufferSource for inputs. · c497edf · heycam/webidl]] ([TIME[2014-10-10 08:31:10 +09:00]] 版) - [43] [CITE@en[Use BufferSource rather than ArrayBufferView https://www.w3.org/Bugs/Pub... · 99cfaf7 · whatwg/encoding]] ([TIME[2014-10-10 08:31:52 +09:00]] 版) - [44] [CITE@en[Use new BufferSource concept from IDL · 0511b50 · whatwg/fetch]] ([TIME[2014-10-10 08:32:05 +09:00]] 版) ]REFS] [46] [CITE@en[W3C bug 27110. Fix the typo in the BufferSource typedef. · 74480d0 · heycam/webidl]] ( ([TIME[2014-10-21 09:50:15 +09:00]] 版)) [55] [CITE@en[Update ECMAScript and IDL integration · whatwg/html@52f96c4]] ([TIME[2015-12-16 12:24:49 +09:00]] 版) [56] [CITE@en[Fix #26: allocating an ArrayBuffer can fail · whatwg/xhr@6484330]] ([TIME[2016-01-22 23:27:23 +09:00]] 版) [57] [CITE@en[Write structured clone algorithm in terms of ECMAScript · whatwg/html@bfb960c]] ([TIME[2016-03-02 16:43:01 +09:00]] 版) [58] [CITE@en[Handle an ArrayBuffer allocation failure · whatwg/fetch@3004ebc]] ([TIME[2016-03-09 15:27:35 +09:00]] 版) [59] [CITE@en[Use BufferSource instead of ArrayBuffer or ArrayBufferView.]] ([[mkruisselbrink]]著, [TIME[2016-07-22 07:26:26 +09:00]]) [60] [CITE@en[24072 – Clarify handling of neutered objects]] ([TIME[2016-08-25 12:01:48 +09:00]]) [61] [CITE@en[Merge algo and dfn for "detaching an ArrayBuffer" (#210)]] ([[tobie]]著, [TIME[2016-10-28 02:15:30 +09:00]]) [62] [CITE@en[Only fail to allocate an ArrayBuffer once]] ([[annevk]]著, [TIME[2017-03-07 19:51:45 +09:00]]) [63] [CITE@en[Breaking: refactor structured clone into serialize/deserialize]] ([[domenic]]著, [TIME[2017-03-21 06:09:33 +09:00]]) [64] [CITE@en[Breaking: refactor structured clone into serialize/deserialize]] ([[domenic]]著, [TIME[2017-03-21 06:09:33 +09:00]]) [65] [CITE@en[Add '''['''AllowShared''']''' to allow accepting SharedArrayBuffers]] ([[domenic]]著, [TIME[2017-04-29 07:10:34 +09:00]]) [66] [CITE@en[Throwing when converting detached ArrayBuffers is not what browsers do · Issue #352 · heycam/webidl]] ([TIME[2017-05-14 21:40:05 +09:00]]) [67] [CITE@en[Replace TypedArray spec and IDL links with links to ECMAScript spec · Issue #2203 · KhronosGroup/WebGL]] ([TIME[2017-05-14 21:41:32 +09:00]]) [48] [CITE@en[Uint8ClampedArray does not have a '''[''''''['''Detached''']'''''']''' internal slot]] ([[annevk]]著, [TIME[2018-01-13 03:52:06 +09:00]]) [68] [CITE@en['''[''''''['''ViewedArrayBuffer''']'''''']''' cannot be undefined during usage]] ([[annevk]]著, [TIME[2019-01-09 23:43:23 +09:00]]) [70] [CITE@en['''[''''''['''ViewedArrayBuffer''']'''''']''' cannot be undefined during usage]] ([[annevk]]著, [TIME[2019-01-09 23:43:23 +09:00]]) [80] [CITE@en["get a copy of the bytes held by the buffer source" should not fail for detached buffers · Issue #151 · heycam/webidl]] ([TIME[2019-06-05 20:05:32 +09:00]]) [82] [CITE@en['''[''''''['''ViewedArrayBuffer''']'''''']''' cannot be undefined during usage by annevk · Pull Request #604 · heycam/webidl]] ([TIME[2019-06-05 20:05:38 +09:00]])