言語
日本語
English

Caution

お使いのブラウザはJavaScriptが無効になっております。
当サイトでは検索などの処理にJavaScriptを使用しています。
より快適にご利用頂くため、JavaScriptを有効にしたうえで当サイトを閲覧することをお勧めいたします。

JavaScript辞典

  1. トップページ
  2. JavaScript辞典
  3. Array.from() / Array.isArray()

Array.from() / Array.isArray()

対応: ES6(ECMAScript 2015)

配列を生成・判定するための静的メソッドです。『Array.from()』は配列風のオブジェクトから配列を作成し、『Array.isArray()』は値が配列かどうかを判定します。

構文

// 配列風オブジェクトやイテラブルから配列を作成
var arr = Array.from(配列風オブジェクト, マッピング関数);

// 値が配列かどうかを判定
var result = Array.isArray(値);

// 引数を要素として配列を作成
var arr = Array.of(要素1, 要素2, ...);

メソッド一覧

メソッド概要
Array.from(対象, 関数)配列風オブジェクトやイテラブルから新しい配列を作成します。第2引数にマッピング関数を指定すると、各要素を変換しながら配列を作成できます。
Array.isArray(値)指定した値が配列であれば『true』、そうでなければ『false』を返します。
Array.of(要素1, 要素2, ...)引数に指定した値を要素として新しい配列を作成します。『new Array()』と異なり、数値を1つ渡しても配列の長さとして扱われません。

サンプルコード

// 文字列から配列を作成
var chars = Array.from("Hello");
console.log(chars);

// NodeListを配列に変換
var items = document.querySelectorAll("li");
var arr = Array.from(items);
console.log(Array.isArray(arr));

// マッピング関数で変換しながら配列を作成
var numbers = Array.from([1, 2, 3], function(n) {
	return n * 10;
});
console.log(numbers);

// 連番の配列を作成
var range = Array.from({ length: 5 }, function(_, i) {
	return i + 1;
});
console.log(range);

// Array.isArrayで型を判定
console.log(Array.isArray([1, 2, 3]));
console.log(Array.isArray("abc"));
console.log(Array.isArray({ length: 3 }));

// Array.of()で配列を作成
console.log(Array.of(3));
console.log(new Array(3));
[ 'H', 'e', 'l', 'l', 'o' ]
true
[ 10, 20, 30 ]
[ 1, 2, 3, 4, 5 ]
true
false
false
[ 3 ]
[ <3 empty items> ]

よくあるミス

ミス1: Array.fromとArray.ofの違いを混同する

Array.from()は配列風オブジェクトやイテラブルを本物の配列に変換するメソッドです。Array.of()は引数をそのまま要素として配列を作るメソッドです。特に数値1つを渡したときの挙動が大きく異なります。

// NG: Array.fromで数値を渡すと長さ3の空配列になる
var wrong = Array.from(3); // 配列風オブジェクトでないためTypeError

修正後は次の通りです。

// OK: 要素として3を持つ配列を作るにはArray.of()を使う
var correct = Array.of(3); // [3]
// OK: 長さ3の連番配列を作るにはArray.from({ length: 3 })を使う
var range = Array.from({ length: 3 }, function(_, i) { return i + 1; }); // [1, 2, 3]

ミス2: マッピング関数を使わずにmapを別途呼ぶ

Array.from()の第2引数にマッピング関数を渡すと、変換と配列生成を1回の処理で行えます。一度配列に変換してからmapを呼ぶより簡潔に書けます。

// NG: 変換してからmapで処理するのは冗長
var items = document.querySelectorAll("li");
var texts = Array.from(items).map(function(el) { return el.textContent; });

修正後は次の通りです。

// OK: Array.fromの第2引数でまとめて処理できる
var items = document.querySelectorAll("li");
var texts = Array.from(items, function(el) { return el.textContent; });

概要

『Array.from()』『Array.isArray()』『Array.of()』はいずれも『Array』コンストラクタの静的メソッドです。インスタンスではなく『Array』に直接呼び出す点が、『配列.push()』や『配列.map()』のようなインスタンスメソッドとは異なります。

『Array.from()』は『document.querySelectorAll()』が返す『NodeList』のように、配列に似ているが配列のメソッドが使えないオブジェクトを本物の配列に変換する際に特に便利です。変換後は『配列.forEach()』や『配列.filter()』などすべての配列メソッドが使用可能になります。『{ length: n }』を渡して連番の配列を作るテクニックも実務でよく使われます。

『Array.isArray()』は値が配列かどうかを確実に判定できる唯一の方法です。『typeof []』は『"object"』を返すため、typeofでは配列とオブジェクトを区別できません。配列かどうかの判定には必ず『Array.isArray()』を使用してください。

対応ブラウザ

Chrome Chrome
50 以降
44 以前 ×
Firefox Firefox
57 以降
31 以前 ×
Safari Safari
18 以降
8 以前 ×
Edge Edge
80 以降
11 以前 ×
IE IE
11 ×
全バージョンで非対応
Opera Opera
48 以降
31 以前 ×
iOS Safari iOS Safari
18 以降
8 以前 ×
Android Browser Android Browser
50 以降
44 以前 ×
Chrome Android Chrome Android
50 以降
44 以前 ×
Firefox Android Firefox Android
79 以降
31 以前 ×

記事の間違いや著作権の侵害等ございましたらお手数ですがまでご連絡頂ければ幸いです。