TypedArray.prototype.map() - JavaScript | MDN

Toggle sidebar

Theme

OS default
Light
Dark

日本語

Remember language Learn more

TypedArray.prototype.map()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2016年9月.

map() は TypedArray インスタンスのメソッドで、与えられた関数を呼び出された型付き配列のすべての要素に対して呼び出し、その結果からなる新しい型付き配列を生成します。このメソッドは、 Array.prototype.map() と同じアルゴリズムです。

試してみましょう

const uint8 = new Uint8Array([25, 36, 49]);
const roots = uint8.map(Math.sqrt);

console.log(roots);
// 予想される結果: Uint8Array [5, 6, 7]

構文

js
map(callbackFn)
map(callbackFn, thisArg)

引数

callbackFn

型付き配列のそれぞれの要素に対して実行する関数。その返値は、新しい型付き配列の単一の要素として追加されます。この関数は以下の引数で呼び出されます。

element

型付き配列で現在処理されている要素です。

index

現在処理中の要素の型付き配列内におけるインデックスです。

array

map() が呼び出されてた型付き配列です。

thisArg 省略可

callbackFn を実行する際に this として使用する値。反復処理メソッドを参照してください。

返値

各要素がコールバック関数の結果である新しい型付き配列です。

解説

詳細については、 Array.prototype.map() をご覧ください。このメソッドは汎用的ではなく、型付き配列インスタンスに対してのみ呼び出すことができます。

例

型付き配列を平方根の型付き配列にマッピング

次のコードは型付き配列を取り、最初の型付き配列にある数値の平方根からなる新しい型付き配列を生成します。

js
const numbers = new Uint8Array([1, 4, 9]);
const roots = numbers.map(Math.sqrt);
// roots の内容は [1, 2, 3] となる
// numbers の内容は [1, 4, 9] のまま

引数を含む関数を使用して型付き配列をマッピングする

次のコードは、1 つの引数を必要とする関数を使用するときに map() がどのように動作するかを示しています。引数は元の配列を通した map() ループとして、配列の各要素に自動的に割り当てられます。

js
const numbers = new Uint8Array([1, 4, 9]);
const doubles = numbers.map((num) => num * 2);
// doubles は Uint8Array [2, 8, 18] となる
// numbers は Uint8Array [1, 4, 9] のまま

仕様書

Specification

ECMAScript® 2027 Language Specification
# sec-%typedarray%.prototype.map

ブラウザーの互換性

Enable JavaScript to view this browser compatibility table.

Help improve MDN

Was this page helpful to you?

Yes No

Learn how to contribute

This page was last modified on 2026年1月22日 by MDN contributors.

View this page on GitHub • Report a problem with this content

標準組み込みオブジェクト
TypedArray
静的メソッド
1. from()
2. of()
静的プロパティ
1. BYTES_PER_ELEMENT
2. [Symbol.species]
インスタンスメソッド
1. at()
2. copyWithin()
3. entries()
4. every()
5. fill()
6. filter()
7. find()
8. findIndex()
9. findLast()
10. findLastIndex()
11. forEach()
12. includes()
13. indexOf()
14. join()
15. keys()
16. lastIndexOf()
17. map()
18. reduce()
19. reduceRight()
20. reverse()
21. set()
22. slice()
23. some()
24. sort()
25. subarray()
26. toLocaleString()
27. toReversed()
28. toSorted()
29. toString()
30. values()
31. with()
32. [Symbol.iterator]()
インスタンスプロパティ
1. buffer
2. byteLength
3. byteOffset
4. length
継承
Object/Function
静的メソッド
1. apply()
2. bind()
3. call()
4. toString()
5. [Symbol.hasInstance]()
静的プロパティ
1. displayName
2. length
3. name
4. prototype
5. arguments
6. caller
インスタンスメソッド
1. __defineGetter__()
2. __defineSetter__()
3. __lookupGetter__()
4. __lookupSetter__()
5. hasOwnProperty()
6. isPrototypeOf()
7. propertyIsEnumerable()
8. toLocaleString()
9. toString()
10. valueOf()
インスタンスプロパティ
1. __proto__
2. constructor
関連するページ
BigInt64Array
BigUint64Array
Float16Array
Float32Array
Float64Array
Int8Array
Int16Array
Int32Array
Uint8Array
Uint8ClampedArray
Uint16Array
Uint32Array