TechHub

エンジニアの成長をサポートする技術情報サイト

← 記事一覧に戻る

JavaScriptの配列操作でよく使うメソッドは?完全ガイド

公開日: 2024年1月15日 著者: mogura
JavaScriptの配列操作でよく使うメソッドは?完全ガイド

疑問

JavaScriptで配列を操作する際、どのようなメソッドがよく使われるのでしょうか?それぞれのメソッドの使い分けやベストプラクティスを一緒に学んでいきましょう。

導入

JavaScriptを学び始めたばかりの方にとって、配列の操作は最初の壁の一つかもしれません。配列はデータを効率的に扱うための重要なデータ構造で、JavaScriptには配列を操作するための便利なメソッドが多数用意されています。

ES6(ECMAScript 2015)以降、配列メソッドはさらに強化され、関数型プログラミングのパラダイムを取り入れた強力なツールとなりました。本記事では、実際の開発現場で頻繁に使用される配列メソッドを、実践的なコード例とともに詳しく解説していきます。

JavaScript配列操作のイメージ

解説

1. map()メソッド - 配列の変換

map()メソッドは、配列の各要素に対して関数を実行し、その結果を新しい配列として返します。元の配列は変更されません(イミュータブル)。データの変換やフォーマット変更によく使用されます。

基本的な使い方

`map()`メソッドは、コールバック関数を受け取り、各要素に対して実行します。コールバック関数は、要素、インデックス、元の配列の3つの引数を受け取ることができます。

基本的な使用例

数値配列の各要素を2倍にする例です。

const numbers = [1, 2, 3, 4, 5];
const doubled = numbers.map(num => num * 2);
console.log(doubled); // [2, 4, 6, 8, 10]
console.log(numbers); // [1, 2, 3, 4, 5] (元の配列は変更されない)

オブジェクトの配列を変換

オブジェクトの配列から特定のプロパティを抽出する例です。

const users = [
  { id: 1, name: 'Alice', age: 25 },
  { id: 2, name: 'Bob', age: 30 },
  { id: 3, name: 'Charlie', age: 35 }
];

// 名前の配列を取得
const names = users.map(user => user.name);
console.log(names); // ['Alice', 'Bob', 'Charlie']

// 年齢を1つ増やす
const agedUsers = users.map(user => ({
  ...user,
  age: user.age + 1
}));
console.log(agedUsers);

インデックスを使用する例

インデックスを使用して要素を変換する例です。

const items = ['a', 'b', 'c'];
const indexed = items.map((item, index) => `${index}: ${item}`);
console.log(indexed); // ['0: a', '1: b', '2: c']

2. filter()メソッド - 条件に合う要素の抽出

`filter()`メソッドは、配列の各要素に対して条件をチェックし、条件を満たす要素のみを含む新しい配列を返します。元の配列は変更されません。

基本的な使い方

`filter()`メソッドは、コールバック関数が`true`を返す要素のみを含む新しい配列を返します。条件に合わない要素は除外されます。

基本的な使用例

偶数のみを抽出する例です。

const numbers = [1, 2, 3, 4, 5, 6, 7, 8, 9, 10];
const evens = numbers.filter(num => num % 2 === 0);
console.log(evens); // [2, 4, 6, 8, 10]

オブジェクトの配列をフィルタリング

条件に合うオブジェクトを抽出する例です。

const users = [
  { id: 1, name: 'Alice', age: 25, active: true },
  { id: 2, name: 'Bob', age: 30, active: false },
  { id: 3, name: 'Charlie', age: 35, active: true }
];

// アクティブなユーザーのみを取得
const activeUsers = users.filter(user => user.active);
console.log(activeUsers);

// 30歳以上のユーザーのみを取得
const olderUsers = users.filter(user => user.age >= 30);
console.log(olderUsers);

複雑な条件でのフィルタリング

複数の条件を組み合わせてフィルタリングする例です。

const products = [
  { name: 'Laptop', price: 1000, category: 'Electronics' },
  { name: 'Book', price: 20, category: 'Education' },
  { name: 'Phone', price: 800, category: 'Electronics' }
];

// 価格が500以上でElectronicsカテゴリの商品
const expensiveElectronics = products.filter(
  product => product.price >= 500 && product.category === 'Electronics'
);
console.log(expensiveElectronics);

3. forEach()メソッド - 各要素に対する処理

`forEach()`メソッドは、配列の各要素に対して関数を実行します。新しい配列を返さず、副作用(side effect)を目的とした処理に使用されます。

map()との違い

`forEach()`は新しい配列を返さず、各要素に対して処理を実行するだけです。`map()`は新しい配列を返すため、変換が必要な場合は`map()`を使用します。

基本的な使用例

各要素を出力する例です。

const fruits = ['apple', 'banana', 'orange'];
fruits.forEach(fruit => {
  console.log(fruit);
});
// apple
// banana
// orange

DOM操作の例

DOM要素を操作する例です。

const items = ['Item 1', 'Item 2', 'Item 3'];
const list = document.getElementById('myList');

items.forEach(item => {
  const li = document.createElement('li');
  li.textContent = item;
  list.appendChild(li);
});

インデックスを使用する例

インデックスを使用して処理する例です。

const numbers = [10, 20, 30];
numbers.forEach((num, index) => {
  console.log(`Index ${index}: ${num}`);
});
// Index 0: 10
// Index 1: 20
// Index 2: 30

4. find()とfindIndex()メソッド - 要素の検索

`find()`メソッドは条件に合う最初の要素を返し、`findIndex()`メソッドは条件に合う最初の要素のインデックスを返します。

find()とfilter()の違い

`find()`は最初の1つの要素を返し、`filter()`は条件に合うすべての要素を配列で返します。1つの要素だけが必要な場合は`find()`を使用します。

find()の使用例

条件に合う最初の要素を検索する例です。

const users = [
  { id: 1, name: 'Alice', age: 25 },
  { id: 2, name: 'Bob', age: 30 },
  { id: 3, name: 'Charlie', age: 35 }
];

// 名前が'Bob'のユーザーを検索
const user = users.find(u => u.name === 'Bob');
console.log(user); // { id: 2, name: 'Bob', age: 30 }

// 30歳以上の最初のユーザーを検索
const olderUser = users.find(u => u.age >= 30);
console.log(olderUser); // { id: 2, name: 'Bob', age: 30 }

findIndex()の使用例

条件に合う要素のインデックスを検索する例です。

const numbers = [10, 20, 30, 40, 50];

// 30より大きい最初の要素のインデックス
const index = numbers.findIndex(num => num > 30);
console.log(index); // 3

// 条件に合う要素がない場合
const notFound = numbers.findIndex(num => num > 100);
console.log(notFound); // -1

実践的な使用例

IDでユーザーを検索する例です。

const users = [
  { id: 1, name: 'Alice' },
  { id: 2, name: 'Bob' },
  { id: 3, name: 'Charlie' }
];

function getUserById(id) {
  return users.find(user => user.id === id);
}

const user = getUserById(2);
console.log(user); // { id: 2, name: 'Bob' }

// 見つからない場合
const notFound = getUserById(99);
console.log(notFound); // undefined

5. reduce()メソッド - 配列の集約

`reduce()`メソッドは、配列の各要素に対して関数を実行し、1つの値に集約します。合計値の計算、オブジェクトの変換、配列の平坦化など、様々な用途に使用できます。

基本的な構文

`reduce()`メソッドは、アキュムレータ(累積値)と現在の要素を受け取り、次のアキュムレータを返します。初期値を指定することもできます。

合計値の計算

配列の合計値を計算する例です。

const numbers = [1, 2, 3, 4, 5];
const sum = numbers.reduce((accumulator, current) => {
  return accumulator + current;
}, 0);
console.log(sum); // 15

// より簡潔に
const sum2 = numbers.reduce((acc, curr) => acc + curr, 0);
console.log(sum2); // 15

オブジェクトの変換

配列をオブジェクトに変換する例です。

const users = [
  { id: 1, name: 'Alice' },
  { id: 2, name: 'Bob' },
  { id: 3, name: 'Charlie' }
];

// IDをキーとするオブジェクトに変換
const usersById = users.reduce((acc, user) => {
  acc[user.id] = user;
  return acc;
}, {});
console.log(usersById);
// { 1: { id: 1, name: 'Alice' }, 2: { id: 2, name: 'Bob' }, ... }

配列の平坦化

ネストされた配列を平坦化する例です。

const nested = [[1, 2], [3, 4], [5, 6]];
const flattened = nested.reduce((acc, curr) => {
  return acc.concat(curr);
}, []);
console.log(flattened); // [1, 2, 3, 4, 5, 6]

// またはスプレッド演算子を使用
const flattened2 = nested.reduce((acc, curr) => [...acc, ...curr], []);
console.log(flattened2); // [1, 2, 3, 4, 5, 6]

最大値・最小値の取得

配列から最大値や最小値を取得する例です。

const numbers = [10, 5, 20, 15, 8];

// 最大値
const max = numbers.reduce((acc, curr) => {
  return curr > acc ? curr : acc;
});
console.log(max); // 20

// 最小値
const min = numbers.reduce((acc, curr) => {
  return curr < acc ? curr : acc;
});
console.log(min); // 5

6. some()とevery()メソッド - 条件チェック

`some()`メソッドは配列の少なくとも1つの要素が条件を満たすかチェックし、`every()`メソッドは配列のすべての要素が条件を満たすかチェックします。どちらも真偽値を返します。

some()とevery()の違い

`some()`は1つでも条件を満たせば`true`を返し、`every()`はすべてが条件を満たす必要があります。空配列の場合、`some()`は`false`を、`every()`は`true`を返します。

some()の使用例

少なくとも1つの要素が条件を満たすかチェックする例です。

const numbers = [1, 2, 3, 4, 5];

// 偶数の要素が存在するか
const hasEven = numbers.some(num => num % 2 === 0);
console.log(hasEven); // true

// 10より大きい要素が存在するか
const hasLarge = numbers.some(num => num > 10);
console.log(hasLarge); // false

// ユーザーに管理者がいるか
const users = [
  { name: 'Alice', role: 'user' },
  { name: 'Bob', role: 'admin' },
  { name: 'Charlie', role: 'user' }
];
const hasAdmin = users.some(user => user.role === 'admin');
console.log(hasAdmin); // true

every()の使用例

すべての要素が条件を満たすかチェックする例です。

const numbers = [2, 4, 6, 8, 10];

// すべての要素が偶数か
const allEven = numbers.every(num => num % 2 === 0);
console.log(allEven); // true

// すべての要素が10より大きいか
const allLarge = numbers.every(num => num > 10);
console.log(allLarge); // false

// すべてのユーザーがアクティブか
const users = [
  { name: 'Alice', active: true },
  { name: 'Bob', active: true },
  { name: 'Charlie', active: true }
];
const allActive = users.every(user => user.active);
console.log(allActive); // true

バリデーションの例

フォームのバリデーションに使用する例です。

const formData = {
  email: 'user@example.com',
  age: 25,
  password: 'secure123'
};

// すべてのフィールドが入力されているか
const allFieldsFilled = Object.values(formData).every(
  value => value !== '' && value !== null && value !== undefined
);
console.log(allFieldsFilled); // true

// 少なくとも1つのフィールドが空か
const hasEmptyField = Object.values(formData).some(
  value => value === '' || value === null || value === undefined
);
console.log(hasEmptyField); // false

7. メソッドのチェーン - 複数の処理を組み合わせる

配列メソッドはチェーンして使用できます。複数のメソッドを連続して呼び出すことで、複雑なデータ処理を簡潔に記述できます。

チェーンの順序

メソッドチェーンの順序は重要です。フィルタリングを先に行うことで、後続の処理を効率化できます。また、`filter()`を`map()`の前に配置することで、不要な要素を先に除外できます。

基本的なチェーンの例

複数のメソッドをチェーンして使用する例です。

const numbers = [1, 2, 3, 4, 5, 6, 7, 8, 9, 10];

// 偶数のみを抽出して2倍にする
const doubledEvens = numbers
  .filter(num => num % 2 === 0)
  .map(num => num * 2);
console.log(doubledEvens); // [4, 8, 12, 16, 20]

実践的な例

ユーザーデータを処理する実践的な例です。

const users = [
  { id: 1, name: 'Alice', age: 25, active: true },
  { id: 2, name: 'Bob', age: 30, active: false },
  { id: 3, name: 'Charlie', age: 35, active: true },
  { id: 4, name: 'David', age: 20, active: true }
];

// アクティブなユーザーの名前を年齢順に取得
const activeUserNames = users
  .filter(user => user.active)
  .sort((a, b) => a.age - b.age)
  .map(user => user.name);
console.log(activeUserNames); // ['David', 'Alice', 'Charlie']

複雑なデータ処理

複数の条件と変換を組み合わせる例です。

const products = [
  { name: 'Laptop', price: 1000, category: 'Electronics', stock: 5 },
  { name: 'Book', price: 20, category: 'Education', stock: 0 },
  { name: 'Phone', price: 800, category: 'Electronics', stock: 10 },
  { name: 'Tablet', price: 600, category: 'Electronics', stock: 3 }
];

// 在庫があり、価格が500以上のElectronics商品の名前と価格
const expensiveElectronics = products
  .filter(p => p.category === 'Electronics')
  .filter(p => p.stock > 0)
  .filter(p => p.price >= 500)
  .map(p => ({ name: p.name, price: p.price }));
console.log(expensiveElectronics);

8. パフォーマンスの考慮

配列メソッドは便利ですが、大量のデータを処理する場合やパフォーマンスが重要な場面では、従来の`for`ループとの使い分けを検討する必要があります。

パフォーマンスの比較

一般的に、`for`ループは配列メソッドよりも高速です。しかし、可読性と保守性の観点から、配列メソッドの方が優れています。パフォーマンスが重要な場面では、プロファイリングを行って最適な方法を選択します。

パフォーマンスの比較例

配列メソッドとforループのパフォーマンスを比較する例です。

const largeArray = Array.from({ length: 1000000 }, (_, i) => i);

// 配列メソッドを使用
console.time('Array methods');
const result1 = largeArray
  .filter(num => num % 2 === 0)
  .map(num => num * 2);
console.timeEnd('Array methods');

// forループを使用
console.time('For loop');
const result2 = [];
for (let i = 0; i < largeArray.length; i++) {
  if (largeArray[i] % 2 === 0) {
    result2.push(largeArray[i] * 2);
  }
}
console.timeEnd('For loop');

効率的なチェーンの例

パフォーマンスを考慮したメソッドチェーンの例です。

// 非効率的: すべての要素を変換してからフィルタリング
const inefficient = numbers
  .map(num => num * 2)
  .filter(num => num > 10);

// 効率的: フィルタリングを先に行う
const efficient = numbers
  .filter(num => num > 5)  // 先にフィルタリング
  .map(num => num * 2);   // 必要な要素だけを変換

9. よくある間違いとベストプラクティス

配列メソッドを使用する際によくある間違いと、ベストプラクティスを紹介します。適切な使い方を理解することで、バグを防ぎ、コードの品質を向上させることができます。

間違いの例

よくある間違いとして、`forEach()`で新しい配列を作成しようとする、`map()`の戻り値を無視する、`reduce()`の初期値を忘れる、などがあります。

ベストプラクティス

ベストプラクティスとして、適切なメソッドを選択する、メソッドチェーンを適度に使用する、可読性を優先する、パフォーマンスが重要な場面では`for`ループを検討する、などがあります。

よくある間違い

よくある間違いの例です。

// 間違い: forEach()で新しい配列を作成しようとする
const numbers = [1, 2, 3];
const doubled = [];
numbers.forEach(num => {
  doubled.push(num * 2);  // 動作するが、map()を使うべき
});

// 正しい: map()を使用
const doubled2 = numbers.map(num => num * 2);

// 間違い: map()の戻り値を無視する
numbers.map(num => num * 2);  // 結果を使用していない

// 間違い: reduce()の初期値を忘れる(数値の合計などでは問題ないが、オブジェクトの場合は必要)
const items = [{ value: 1 }, { value: 2 }];
const sum = items.reduce((acc, item) => acc + item.value);  // 動作する

// しかし、オブジェクトを返す場合は初期値が必要
const grouped = items.reduce((acc, item) => {
  acc[item.value] = item;
  return acc;
}, {});  // 初期値{}が必要

ベストプラクティス

配列メソッドを使用する際のベストプラクティスです。

// 1. 適切なメソッドを選択
// 変換が必要: map()
// フィルタリング: filter()
// 検索: find()
// 集約: reduce()
// 副作用のみ: forEach()

// 2. メソッドチェーンを適度に使用(3-4個までが目安)
const result = users
  .filter(user => user.active)
  .map(user => user.name)
  .sort();

// 3. 可読性を優先
// 長いチェーンは分割する
const activeUsers = users.filter(user => user.active);
const names = activeUsers.map(user => user.name);
const sortedNames = names.sort();

// 4. コールバック関数に名前を付ける(複雑な場合)
const isActive = user => user.active;
const getName = user => user.name;
const activeUserNames = users
  .filter(isActive)
  .map(getName);

まとめ

JavaScriptの配列操作では、map()filter()forEach()find()reduce()などのメソッドが頻繁に使用されます。それぞれのメソッドには特徴があり、適切に使い分けることで、コードの可読性と効率性が向上します。

メソッドチェーンを活用することで、複雑なデータ処理も簡潔に記述できますが、パフォーマンスが重要な場面では、従来のforループとの使い分けも検討しましょう。

これらのメソッドをマスターすることで、より高度で保守性の高いJavaScriptコードを書くことができます。実践的なプロジェクトで積極的に使用し、経験を積むことが上達への近道です。

JavaScriptの非同期処理とは?Promiseとasync/awaitの使い方