【JavaScript】イベントの連続発火を防ぐ!「デバウンス(Debounce)」の仕組みと比較デモ

JavaScriptで検索フォームの入力監視(input)、画面のスクロール(scroll)、ウィンドウのリサイズ(resize)といったイベントを扱う際、そのまま処理を書いてしまうと「1秒間に何十回も関数が実行されてしまい、ブラウザが重くなる(またはAPI通信が大量に発生してしまう)」という問題が起こります。

こうしたイベントの過剰な連続発火を防ぎ、パフォーマンスを改善するテクニックが「デバウンス(Debounce:処理の間引き)」です!

デバウンスを取り入れると、イベントが連続して発生している間は処理を待機し、「ユーザーの操作が止まってから指定時間後に1回だけ実行する」という制御が可能になります。 今回は、input イベントと scroll イベントで「デバウンスなし・あり」の実行回数の違いがわかる比較デモと一緒に、その仕組みと実装方法を解説します!

デモ動作

See the Pen JSのデバウンス(Debounce)処理 by mikanbako (@mikanbako) on CodePen.

全画面でのデモ動作は以下のリンクからご確認下さい!(別タブで開かれます)

実装コード紹介

【HTML】

<div class="l-wrap">
  <h2>デバウンス(Debounce)比較デモ</h2>
  <p class="p-desc">「通常(毎回発火)」と「デバウンスあり(操作停止から0.5秒後に発火)」の実行回数の違いを比較してみよう!</p>
  
  <div class="p-demo-box">
    
    <!-- 💡 デモ1:inputイベント(文字入力) -->
    <section class="p-section">
      <h3 class="c-sec-title">① inputイベント(検索窓などの文字入力)</h3>
      <input type="text" class="c-input js-input" placeholder="ここに連続で文字を入力してみてね!">
      
      <div class="c-comp-grid">
        <!-- デバウンスなし -->
        <div class="c-result-card">
          <div class="c-card-label">通常(デバウンスなし)</div>
          <div class="c-count">実行回数: <span class="js-input-normal-count">0</span> 回</div>
          <div class="c-text-out js-input-normal-text">入力値: -</div>
        </div>
        <!-- デバウンスあり -->
        <div class="c-result-card c-result-card--debounce js-input-card">
          <div class="c-card-label">✨ デバウンスあり (500ms)</div>
          <div class="c-count">実行回数: <span class="js-input-debounce-count">0</span> 回</div>
          <div class="c-text-out js-input-debounce-text">確定値: -</div>
        </div>
      </div>
    </section>

    <!-- 💡 デモ2:scrollイベント(スクロール操作) -->
    <section class="p-section">
      <h3 class="c-sec-title">② scrollイベント(スクロールの検知)</h3>
      
      <!-- スクロール用のボックス -->
      <div class="c-scroll-box js-scroll-box">
        <div class="c-scroll-inner">
          <p>👇 このエリアを上下にたくさんスクロールしてみてね!</p>
          <p>スクロール中は通常のイベントが発火し続けますが、デバウンスありの方は「スクロールが止まってから0.5秒後」に1回だけ実行されます!</p>
          <p>一番下までスクロールできるよ!🎉</p>
        </div>
      </div>

      <div class="c-comp-grid">
        <!-- デバウンスなし -->
        <div class="c-result-card">
          <div class="c-card-label">通常(デバウンスなし)</div>
          <div class="c-count">実行回数: <span class="js-scroll-normal-count">0</span> 回</div>
          <div class="c-text-out js-scroll-normal-pos">位置: 0px</div>
        </div>
        <!-- デバウンスあり -->
        <div class="c-result-card c-result-card--debounce js-scroll-card">
          <div class="c-card-label">✨ デバウンスあり (500ms)</div>
          <div class="c-count">実行回数: <span class="js-scroll-debounce-count">0</span> 回</div>
          <div class="c-text-out js-scroll-debounce-pos">停止位置: 0px</div>
        </div>
      </div>
    </section>

  </div>
</div>

【CSS】

/* ベース装飾 */
.l-wrap {
  padding: 40px 20px;
  max-width: 650px;
  margin: 0 auto;
  color: #3e3e3e;
  text-align: center;
}

h2 {
  margin-bottom: 10px;
  font-size: 16px;
  color: #1bb4d4;
}

.p-desc {
  margin-bottom: 25px;
  font-size: 16px;
  font-weight: bold;
  color: #666;
  line-height: 1.6;
}

.p-demo-box {
  display: flex;
  flex-direction: column;
  gap: 30px;
  padding: 30px;
  background: #fff;
  border-radius: 12px;
  box-shadow: 0 4px 15px rgb(0 0 0 / 5%);
}

/* セクション共通 */
.p-section {
  padding: 20px;
  text-align: left;
  background: #f8f9fa;
  border: 1px solid #e9ecef;
  border-radius: 8px;
}

.c-sec-title {
  padding-left: 10px;
  margin-bottom: 15px;
  font-size: 16px;
  color: #1bb4d4;
  border-left: 4px solid #1bb4d4;
}

/* 入力フォーム */
.c-input {
  width: 100%;
  padding: 12px 15px;
  margin-bottom: 15px;
  font-size: 16px;
  border: 2px solid #ccc;
  border-radius: 6px;
  transition: 0.2s;
}

.c-input:focus {
  border-color: #1bb4d4;
}

/* スクロールボックス */
.c-scroll-box {
  height: 130px;
  padding: 15px;
  margin-bottom: 15px;
  overflow-y: scroll;
  background: #fff;
  border: 2px solid #ccc;
  border-radius: 6px;
}

.c-scroll-inner {
  display: flex;
  flex-direction: column;
  justify-content: space-between;
  height: 350px;
  font-size: 16px;
  font-weight: bold;
  color: #555;
}

.c-scroll-inner p {
  padding: 10px;
  background: #e0f7fa;
  border-radius: 6px;
  line-height: 1.6; 
}

/* 比較グリッドとカード */
.c-comp-grid {
  display: grid;
  grid-template-columns: 1fr 1fr;
  gap: 15px;
}

.c-result-card {
  padding: 15px;
  text-align: center;
  background: #fff;
  border: 2px solid #ddd;
  border-radius: 8px;
  transition: 0.2s;
}

.c-result-card--debounce {
  background: #f0fbfc;
  border-color: #1bb4d4;
}

/* デバウンス発火時にピカッと光らせるクラス */
.is-fired {
  background: #ffe4e1 !important;
  border-color: #e83e8c !important;
  transform: scale(1.02);
}

.c-card-label {
  margin-bottom: 8px;
  font-size: 14px;
  font-weight: bold;
  color: #666;
}

.c-count {
  margin-bottom: 5px;
  font-size: 16px;
  font-weight: bold;
}

.c-count span {
  font-family: monospace;
  font-size: 24px;
  color: #e83e8c;
}

.c-text-out {
  padding: 6px;
  font-size: 14px;
  color: #555;
  word-break: break-all;
  background: #f1f3f5;
  border-radius: 4px;
}

【JavaScript】

// デバウンス発火時にカードを少しだけ光らせる演出用関数
const flashCard = (cardElement) => {
  cardElement.classList.add('is-fired');
  setTimeout(() => cardElement.classList.remove('is-fired'), 300);
};

// =========================================
// 💡 1. inputイベントの比較処理
// =========================================
const inputEl = document.querySelector('.js-input');
const inputNormalCount = document.querySelector('.js-input-normal-count');
const inputNormalText = document.querySelector('.js-input-normal-text');
const inputDebounceCount = document.querySelector('.js-input-debounce-count');
const inputDebounceText = document.querySelector('.js-input-debounce-text');
const inputCard = document.querySelector('.js-input-card');

let normalInputCounter = 0;
let debounceInputCounter = 0;
let inputTimerId = null; // デバウンス用のタイマーID

inputEl.addEventListener('input', (event) => {
  const value = event.target.value;

  // 【通常処理】文字を打つたびに毎回すぐ実行される
  normalInputCounter++;
  inputNormalCount.textContent = normalInputCounter;
  inputNormalText.textContent = `入力値: ${value || '-'}`;

  // 【デバウンス処理】
  // 1. 前回のタイマー予約があればキャンセルする(リセット)
  clearTimeout(inputTimerId);

  // 2. 新しく500ミリ秒(0.5秒)後に実行するタイマーを予約する
  inputTimerId = setTimeout(() => {
    debounceInputCounter++;
    inputDebounceCount.textContent = debounceInputCounter;
    inputDebounceText.textContent = `確定値: ${value || '-'}`;
    flashCard(inputCard);
  }, 500);
});


// =========================================
// 💡 2. scrollイベントの比較処理
// =========================================
const scrollBox = document.querySelector('.js-scroll-box');
const scrollNormalCount = document.querySelector('.js-scroll-normal-count');
const scrollNormalPos = document.querySelector('.js-scroll-normal-pos');
const scrollDebounceCount = document.querySelector('.js-scroll-debounce-count');
const scrollDebouncePos = document.querySelector('.js-scroll-debounce-pos');
const scrollCard = document.querySelector('.js-scroll-card');

let normalScrollCounter = 0;
let debounceScrollCounter = 0;
let scrollTimerId = null; // デバウンス用のタイマーID

scrollBox.addEventListener('scroll', () => {
  const scrollTop = Math.round(scrollBox.scrollTop);

  // 【通常処理】スクロール中、1ピクセル動くたびに実行される
  normalScrollCounter++;
  scrollNormalCount.textContent = normalScrollCounter;
  scrollNormalPos.textContent = `位置: ${scrollTop}px`;

  // 【デバウンス処理】
  // スクロールが続いている間は clearTimeout され続け、止まってから0.5秒後に1回だけ実行!
  clearTimeout(scrollTimerId);

  scrollTimerId = setTimeout(() => {
    debounceScrollCounter++;
    scrollDebounceCount.textContent = debounceScrollCounter;
    scrollDebouncePos.textContent = `停止位置: ${scrollTop}px`;
    flashCard(scrollCard);
  }, 500);
});

デバウンスの仕組みと活用シーン・汎用関数

デバウンス(Debounce)の仕組みはとってもシンプル!

「デバウンス」という言葉は少し難しそうに聞こえますが、やっていることは以前紹介した setTimeout() と clearTimeout() の組み合わせだけです!

  1. イベントが発生したら、まず clearTimeout(timerId) で「前回の予約」をキャンセルする。
  2. すぐに timerId = setTimeout(..., 500) で「0.5秒後に実行する新しい予約」を入れる。

ユーザーが連続して文字を打ったりスクロールしたりしている間(0.5秒以内に次のイベントが起きている間)は、1. のキャンセル処理が働き続けるため、いつまで経っても中身が実行されません。そして「ユーザーの操作が止まって0.5秒が経過した瞬間」に、初めて1回だけ処理が実行される仕組みです!

デバウンスが活用されるよくある例

① 検索窓のオートコンプリート(input イベント)
文字を1文字打つたびにサーバーへAPI通信(検索リクエスト)を送ってしまうと、サーバーに多大な負荷がかかります。デバウンスを使えば「ユーザーが文字を打ち終わったタイミング」で1回だけ検索を行えます。

② ウィンドウのリサイズ処理(resize イベント)
画面幅をドラッグして変えている最中にレイアウトの再計算を毎回行うと画面がカクつきます。「リサイズが終わった瞬間」に1回だけ計算させるのが鉄則です。

③ スクロール終了の検知や位置の保存(scroll イベント)
1回のスクロール操作で数十〜数百回も発火するイベントを間引き、「スクロールが止まった位置」を取得して処理したい時に活躍します。

応用:使い回せる「汎用 debounce 関数」を作っておこう!

複数の場所にデバウンスを適用したい場合、毎回 let timerId を用意するのは大変です。以下のように、関数を受け取ってデバウンス化してくれる「汎用関数」を1つ用意しておくと、どんなイベントにも1行で適用できて非常にスマートです!

// 汎用的なデバウンス関数
const debounce = (func, wait = 500) => {
  let timerId = null;
  return (...args) => {
    clearTimeout(timerId);
    timerId = setTimeout(() => {
      func(...args);
    }, wait);
  };
};

// 使い方:実行したい関数と待ち時間(ミリ秒)を渡すだけ!
window.addEventListener('resize', debounce(() => {
  console.log('リサイズが完了しました!');
}, 300));

補足:公式ドキュメント

・MDN: setTimeout()
・MDN: clearTimeout()

まとめ

今回はイベントの連続発火を間引いてパフォーマンスを向上させる「デバウンス(Debounce)処理」について解説しました。

デモで体感していただいた通り、通常のイベントでは数十回〜数百回と発火してしまう処理も、clearTimeout と setTimeout を組み合わせたデバウンスを取り入れるだけで、本当に必要な「最後の1回」だけに減らすことができます。

ユーザーにとってもサーバーにとっても優しい、Webサイトやアプリを作る上で必須のテクニックですので、ぜひ積極的に取り入れてみてください!

Prev
Next