MATOME. 学びを、つなぐ。

javascript / LEARNING NOTE

JavaScript開発の落とし穴|最適化とイベント解除の確認点

確認・更新:2026年10月27日。JavaScriptの改善は、短くする前に「動作が同じか」を確かめることが大切です。この記事では、共有状態・非同期処理・DOM更新・イベント解除・計算処理等の落とし穴を扱います。特に最適化の結果が変わる誤例と、イベント解除の構文不備を訂正し、確認条件を具体化しました。各コード例は原則独立し、依存する例はその旨を記載しています。

グローバル変数の乱用

グローバル変数の問題点

JavaScriptでは、関数やオブジェクトを定義しなくてもグローバル変数を作成することができます。
しかし、グローバル変数を多用すると、スコープの管理が複雑化し、
バグや予測不能な動作の原因となることがよくあります。
特に、複数の関数やモジュールが同じグローバル変数を参照・変更する場合、
意図せずにデータが上書きされてしまうリスクがあります。

var count = 0;

function increment() {
count++;
}

function reset() {
count = 0;
}

通常のscriptをトップレベルで実行した場合、上記のcountはグローバルな状態になります(ESモジュールや関数内での実行は別です)。
しかし、他の場所で誤って変更される可能性があり、バグの原因となることがあります。

解決策

グローバル変数の代わりに、関数やモジュールの内部に変数を閉じ込めることが推奨されます。
let・constへの置換だけで状態が非公開になるわけではありません。次のように関数のローカル変数をクロージャーへ閉じ込め、操作用の関数だけを返します。

function createCounter() {
let count = 0;

return {
increment() {
count++;
},
reset() {
count = 0;
},
getCount() {
return count;
}
};
}

const counter = createCounter();
counter.increment();
console.log(counter.getCount()); // 1

このように、変数を関数のスコープ内に閉じ込めることで、
外部からの不必要なアクセスを防ぐことができます。

コールバック地獄

コールバック地獄とは?

JavaScriptでは、非同期処理が重要な役割を果たします。
そのため、イベントハンドラやAjaxリクエストなど、
非同期の動作を管理するためにコールバック関数が頻繁に使用されます。
しかし、非同期処理が複雑になると、コールバック関数が次々にネストされ、
コードが読みにくくなります。これが「コールバック地獄」と呼ばれる問題です。

// 関数定義を省略した構造説明用の例
// このままでは実行できません
doSomething(function(result) {
doSomethingElse(result, function(newResult) {
doAnotherThing(newResult, function(finalResult) {
console.log(finalResult);
});
});
});

上記のようなコードは、非同期処理が増えるほど読みづらく、保守も困難になります。

解決策

以下のPromise例とasync/await例も、呼び出す関数の定義を省略しています。コールバック型APIが自動的にPromiseになるわけではなく、Promiseを返すAPIを使うことが前提です。イベント等のコールバック自体が非推奨という意味ではありません。
Promise や async/await を使うことで、コールバック地獄を回避し、
より直線的で理解しやすいコードを書くことができます。

doSomething()
.then(result => doSomethingElse(result))
.then(newResult => doAnotherThing(newResult))
.then(finalResult => console.log(finalResult))
.catch(error => console.error(error));

さらに、async/await を使うと、非同期コードが同期的なスタイルで書けるため、
読みやすさが大幅に向上します。

async function process() {
try {
const result = await doSomething();
const newResult = await doSomethingElse(result);
const finalResult = await doAnotherThing(newResult);
console.log(finalResult);
} catch (error) {
console.error(error);
}
}

DOM更新は測定し、要素の存在を確認する

DOM更新が多い画面では、要素数やスタイル計算・レイアウトの負荷を調べます。ただし、appendChildを呼ぶたび必ず画面全体が再描画されるわけではありません。書き込みとレイアウト値の読み取りを交互に行う実装等を、開発者ツールで確認してください。

DocumentFragmentは複数のノードをまとめて組み立てる手段です。常に直接追加より速いとは限らず、性能差より読みやすさが有用な場合もあります。次の例ではリストがないときに停止し、入力文字をtextContentで追加します。

// <ul id="list"></ul>の生成後に実行する
function appendItems(list, items) {
  if (!list) return false;
  const fragment = document.createDocumentFragment();
  for (const item of items) {
    const li = document.createElement("li");
    li.textContent = item;
    fragment.appendChild(li);
  }
  list.appendChild(fragment);
  return true;
}
const list = document.getElementById("list");
console.log(appendItems(list, ["Item 1", "Item 2", "Item 3"]));
// listありならtrue、なしならfalse

この関数は既存内容を消さずに末尾へ追加します。再実行で重複を避けたい画面なら置換・差分更新等の仕様を別途決めます。速度改善は同じデータ量・端末・描画結果で測定し、呼び出し回数だけから断定しません。

型の不一致によるバグ

型変換の罠

JavaScriptは動的型付け言語であるため、異なる型の値を比較したり操作したりする際に、
暗黙の型変換が行われることがあります。これが原因で、予期しない結果が発生することがよくあります。

console.log(1 + '1'); // '11' (文字列として結合される)
console.log(true + 1); // 2 (ブール値が数値に変換される)

解決策

厳密な型チェックを行い、暗黙の型変換を避けることが重要です。
=== や !== を使って、型の一致も含めて値を比較することが推奨されます。

console.log(1 === '1'); // false
console.log(true === 1); // false

また、TypeScriptのような型付けされたJavaScriptの拡張を使用することで、
一部の型の不整合を静的に検出できます。ただし実行時のAPIレスポンスや入力値を自動検証するものではないため、実データの型・範囲等も確認します。

重複コードの乱用

コードのDRY原則違反

同じ処理を複数の場所で繰り返し書くと、コードが冗長になり、
変更が必要な場合にすべての箇所を手動で修正しなければならなくなります。
共通の仕様が複製されているなら、変更漏れを避けるためにまとめる候補です。ただ似ているだけで今後別々に変わる処理まで、無理に統合する必要はありません。

// 以下は共通化済みの例。後の例との差は引数の既定値です。
function calculateTotal(price, tax) {
return price + (price * tax);
}

const item1Total = calculateTotal(100, 0.1);
const item2Total = calculateTotal(200, 0.1);

解決策

共通の処理は関数にまとめ、再利用可能な形にすることが重要です。
これにより、コードが短くなり、保守性が向上します。

function calculateTotal(price, tax = 0.1) {
return price + (price * tax);
}

const item1Total = calculateTotal(100);
const item2Total = calculateTotal(200);

また、共通のロジックをモジュールとして分割し、
プロジェクト全体で再利用できるようにすることも有効です。

イベントリスナーと参照の寿命を管理する

DOMから要素を削除しただけで、リスナーが必ずメモリリークするわけではありません。要素とリスナーが互いを参照していても、外部から到達できなければ回収対象になり得ます。一方、長く生きるwindowやdocumentのリスナー、タイマー、配列等から不要なデータを参照し続けると、解放を妨げることがあります。

画面や部品の終了時に解除する仕組みを用意します。removeEventListenerでは同じイベント型・関数参照・capture指定を使います。次の関数は実際のボタンのほかEventTargetにも使え、解除関数を返します。

function attachHandler(element, onClick) {
  if (!element) return () => {};
  function handleClick(event) {
    onClick(event);
  }
  element.addEventListener("click", handleClick, false);
  return function detachHandler() {
    element.removeEventListener("click", handleClick, false);
  };
}
// ブラウザーでボタン生成後に実行。attachHandlerを先に定義する
const button = document.getElementById("button");
const detachHandler = attachHandler(button, () => {
  console.log("Element clicked");
});

// 実際には画面・部品を終了する処理の中で呼ぶ
// detachHandler();
// button?.remove();

解除後にクリックしても処理が走らないこと、再表示時に二重登録されないことも確認します。WeakMapやWeakSetはキー等の参照保持に関する道具であり、タイマーやイベント登録を自動解除するものではありません。ヒープや不要な参照の推移は別途調べます。

互換コードは対応環境を決めてから整理する

古いブラウザー向けコードを削除する前に、契約・対象端末・WebView・利用実績を確認します。不要なら整理できますが、古いという理由だけで削除は決めません。元のforEach自作例は仕様の一部を省略し、letも含むため、そのまま古い環境対応の完成版として使わないでください。

Webpack等のバンドラーと、Babel等による構文変換、機能を補うポリフィルは役割が異なります。バンドルするだけで全APIが互換になるわけではありません。対応対象と設定を明示し、必要なら標準準拠のポリフィルを選び、対象環境で確認します。

無計画なライブラリやフレームワークの使用

過度な依存の問題点

JavaScriptエコシステムには無数のライブラリやフレームワークが存在しますが、
無計画にこれらに依存すると、プロジェクトの複雑性が増し、保守が困難になることがあります。
特に、短期間で流行が変わるJavaScript界隈では、依存するライブラリが突然廃止されたり、
メンテナンスされなくなったりするリスクもあります。

import _ from 'lodash'; // モジュールの形式やビルド設定も確認する

解決策

ライブラリの導入は必要な機能・保守・安全性・実際の成果物サイズで判断します。上のimport文だけから配信サイズは断定できません。ビルド後のバンドルと実測を確認し、標準APIで十分かも検討します。
また、ライブラリやフレームワークを選定する際には、プロジェクトの長期的な維持管理を考慮し、
活発にメンテナンスされているか、コミュニティのサポートがあるかを確認することが重要です。

最適化は計算結果をそろえてから比較する

二重ループを一重へ変えても、意味が変わったら同じ処理の高速化ではありません。元記事の例は「すべての組み合わせの積の合計」を「各要素の二乗の合計」に置き換えていました。[1,2,3,4,5]では前者225、後者55となり、結果が異なります。

すべての組み合わせの積を合計する処理は、数学的には「合計の二乗」です。次の2関数を同じ入力で比較します。ここでは通常の小さな有限数の配列を想定しています。

function pairProducts(values) {
  let total = 0;
  for (const a of values) {
    for (const b of values) {
      total += a * b;
    }
  }
  return total;
}
function squareOfSum(values) {
  let total = 0;
  for (const value of values) total += value;
  return total * total;
}
const values = [1, 2, 3, 4, 5];
console.log(pairProducts(values)); // 225
console.log(squareOfSum(values)); // 225

ループ回数は前者O(n²)、後者O(n)です。ただしJavaScriptのNumberは浮動小数点数なので、計算順序で丸め誤差やオーバーフローの結果が異なり得ます。小数・大きな値・NaN・Infinityを扱うなら、許容誤差と入力条件を決め、同値性を確認してください。

空配列、負数、0、通常入力を含めて期待値を確認してから、実データ量で時間を測ります。ここでは計算結果と計算量を説明しており、実機の速度改善率を測定したものではありません。

過度なコメントや不適切なコメント

コメントの問題点

コメントはコードの意図を説明するために重要ですが、過度にコメントを追加したり、
逆にコメントが不適切であったりすると、かえってコードの理解を妨げることがあります。
例えば、コードそのものが明らかな場合に、そのコードの説明をコメントで繰り返すことは不要です。

// xに5を代入する
let x = 5;

このようなコメントは冗長であり、コードの可読性を下げるだけでなく、
メンテナンスの際に混乱を招く可能性があります。

解決策

コメントは、コードが意図した通りに動作しているかを理解するのに必要な補足情報として使用します。コメントを書く代わりに、変数名や関数名をわかりやすくすることで、コメントが不要になるケースも多いです。また、コードが複雑な処理を行う場合や、特別な理由でそのような実装が選択された場合に限り、適切なコメントを追加することが推奨されます。

改善前後で確認すること・関連資料

通常入力・空入力・エラー時・終了時を確認し、同じ結果であることを先に確かめます。DOMの速さやメモリ解放をコードの見た目から断定せず、端末・データ量・参照の残り方を測定します。

構文を変更する判断基準はJavaScriptの古い書き方を見直す、メソッドの戻り値は主要メソッド一覧も確認してください。

MDN:DocumentFragment
MDN:removeEventListener
MDN:メモリ管理

WRITTEN BY

小清水 和真株式会社REPRESENT 代表

WebディレクションからWebザイン・コーディングを主に行っております。 2021年株式会社を設立。講師もしております。

運営会社について
MAKE IT YOURS

この学びを、自分のノートへ。

YOUR LEARNING SPACE

読むだけから、
使える知識へ。

気になった記事を保存。気づきをメモ。
あなただけのWeb制作ノートを育てよう。

  • 気になった記事をワンクリックで保存
  • 記事ごとに自分だけの非公開メモ
  • 学習状況をマイライブラリで振り返り
無料で会員登録 登録は無料。ユーザー名とメールアドレスだけで始められます。保存した記事・メモは本人だけが閲覧できます。

この記事へのコメント

メモは非公開です。こちらのコメントは公開されます。

コメントを残す