カテゴリー
お問い合わせ

【JavaScript】API通信が一瞬で終わっても大丈夫！Promise.all() で最低○秒間ローディングを表示させる方法

JavaScript
目次

Webアプリやサイトでデータの取得（非同期処理）を行う際、ユーザーを不安にさせないために「ローディング画面（スピナー等）」を表示するのは必須のUIです。

しかし、実際の通信処理が早すぎた場合（例えば0.1秒で完了した場合）、ローディング画面が一瞬だけ「チラッ」と表示されてすぐに消えてしまい、逆にユーザーの目をチカチカさせてしまう「チラつき問題」が発生することがあります。

これを防ぐために活躍するのがJavaScriptの Promise.all() です！ 今回は「実際の処理」と「最低待機時間のタイマー」を並列で走らせることで、このチラつきを解消するテクニックを、悪い例と良い例のデモを交えてご紹介します。

デモ動作

See the Pen Promise.all()で作る最低ローディング時間 by mikanbako (@mikanbako) on CodePen.

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

実装コードの紹介

【HTML】

<div class="l-wrap">
  <h2>最低ローディング時間 デモ</h2>
  
  <div class="p-demo-area">
    
    <!-- パターン1：悪い例 -->
    <div class="p-card">
      <h3 class="p-card__title">❌ 悪い例（最低待機なし）</h3>
      <p class="p-card__desc">処理が0.1秒で終わるため、ローディングが一瞬だけチラついて不自然です。</p>
      <button class="c-btn js-btn-bad">処理を開始する</button>
    </div>

    <!-- パターン2：良い例 -->
    <div class="p-card">
      <h3 class="p-card__title">⭕️ 良い例（Promise.all活用）</h3>
      <p class="p-card__desc">処理が早く終わっても、最低1秒はローディングを表示して自然に待たせます。</p>
      <button class="c-btn js-btn-good">処理を開始する</button>
    </div>

    <!-- ローディング画面（初期状態は非表示） -->
    <div class="c-loader-overlay js-loader">
      <div class="c-spinner"></div>
      <p class="c-loader-text">Loading...</p>
    </div>

  </div>
</div>

【CSS】

.l-wrap { 
  max-width: 800px;
  margin: 0 auto; 
  padding: 40px 20px;
  color: #3e3e3e;
  text-align: center; 
}
h2 { 
  font-size: 16px;
  color: #1bb4d4;
  margin-bottom: 40px;
}

/* レイアウト */
.p-demo-area {
  position: relative; /* ローディングをこのエリア内に被せるため */
  display: flex;
  gap: 30px;
  justify-content: center;
  padding: 40px;
  background: #fff;
  border-radius: 12px;
  box-shadow: 0 4px 15px rgba(0,0,0,0.05);
  overflow: hidden;
}
.p-card { 
  flex: 1; 
  line-height: 1.5;
}
.p-card__title { 
  font-size: 16px;
  margin-bottom: 12px; 
}
.p-card__desc { 
  font-size: 14px; 
  color: #666;
  margin-bottom: 24px; 
  min-height: 3em; 
}

/* ボタン */
.c-btn {
  padding: 12px 24px;
  font-size: 16px;
  font-weight: bold;
  background-color: #1bb4d4;
  color: #fff;
  border-radius: 8px;
  cursor: pointer;
  transition: opacity 0.3s ease-out;
}
.c-btn:hover { 
  opacity: 0.8; 
}

/* =========================================
   ローディング画面（オーバーレイ）
========================================= */
.c-loader-overlay {
  position: absolute;
  top: 0;
  left: 0;
  width: 100%;
  height: 100%;
  background-color: rgba(255, 255, 255, 0.9);
  display: flex;
  flex-direction: column;
  justify-content: center;
  align-items: center;
  z-index: 10;
  /* JSで切り替えるため初期表示は隠す */
  opacity: 0;
  visibility: hidden;
  transition: opacity 0.3s ease-out;
}
.c-loader-overlay.is-active {
  opacity: 1;
  visibility: visible;
}

/* スピナー */
.c-spinner {
  width: 50px;
  height: 50px;
  border: 5px solid #e0e0e0;
  border-top-color: #1bb4d4;
  border-radius: 50%;
  animation: spin 1s linear infinite;
  margin-bottom: 16px;
}
@keyframes spin {
  0% { 
    transform: rotate(0deg);
  }
  100% { 
    transform: rotate(360deg);
  }
}
.c-loader-text {
  font-size: 16px;
  font-weight: bold;
  color: #1bb4d4;
}

【JavaScript】

// DOM要素の取得
const btnBad = document.querySelector('.js-btn-bad');
const btnGood = document.querySelector('.js-btn-good');
const loader = document.querySelector('.js-loader');

// 指定したミリ秒だけ待機するPromiseを返す関数（最低待機時間用）
const wait = (ms) => new Promise(resolve => setTimeout(resolve, ms));

// 実際の処理を想定したダミー関数（今回は0.1秒で完了すると仮定）
const fetchDummyData = async () => {
  await wait(100); 
  console.log("データの取得が完了しました！");
};

/* =========================================
   ❌ 悪い例（最低待機時間なし）
========================================= */
btnBad.addEventListener('click', async () => {
  // 1. ローディング表示
  loader.classList.add('is-active');

  // 2. 実際の処理（0.1秒）だけを待つ
  await fetchDummyData();

  // 3. ローディング非表示（一瞬で消えるのでチラつく）
  loader.classList.remove('is-active');
});

/* =========================================
   ⭕️ 良い例（Promise.all で最低待機時間を設ける）
========================================= */
btnGood.addEventListener('click', async () => {
  // 1. ローディング表示
  loader.classList.add('is-active');

  // 2. 実際の処理 と 1秒の待機処理 を同時にスタートし、両方終わるのを待つ
  await Promise.all([
    fetchDummyData(), // 0.1秒で終わる
    wait(1000)        // 1秒間待つ
  ]);

  // 3. ローディング非表示（最低1秒は表示された後に消える）
  loader.classList.remove('is-active');
});

コードの解説・仕組み

指定時間待機する関数 wait を作る

// 指定したミリ秒だけ待機するPromiseを返す関数（最低待機時間用）
const wait = (ms) => new Promise(resolve => setTimeout(resolve, ms));

setTimeout を Promise でラップした wait 関数を用意します。これにより、await wait(1000) のように書くだけで指定した秒数だけ処理を待機させることができます。

Promise.all() の特性を利用する

Promise.all([処理A, 処理B]) は、配列で渡された複数の非同期処理を「同時に（並列で）」スタートさせ、その「すべてが完了するまで」待機するというメソッドです。

// 2. 実際の処理 と 1秒の待機処理 を同時にスタートし、両方終わるのを待つ
await Promise.all([
  fetchDummyData(), // 0.1秒で終わる
  wait(1000)        // 1秒間待つ
]);

良い例のデモでは、以下の2つを配列に渡しています。

  • fetchDummyData()：実際の処理（今回は0.1秒）
  • wait(1000)：最低待機時間（1秒）

実際の処理が0.1秒で終わっても、Promise.all 全体としてはもう一つの wait(1000) が終わるまで次の行（非表示処理）へ進みません。逆に、実際の処理に3秒かかった場合は、1秒の待機は既に終わっているので、3秒後にローディングが消えます。

これにより、「早く終わっても最低1秒はローディングを見せつつ、通信が長引いた場合は通信完了までちゃんと見せる」という制御がたった数行で実現できます！

補足：公式ドキュメント

今回使用した Promise.all() は、ローディングの制御以外にも「複数のAPIから同時にデータを取得して、すべて揃ってから画面を描画する」といった場面でも活躍します。 より詳細な仕様や他の活用例について知りたい方は、ぜひMDNの公式ドキュメントもチェックしてみてください！

・MDN: Promise.all()

まとめ

今回は、Promise.all() を活用してローディング画面の不自然な「チラつき」を防止し、最低待機時間を設けるテクニックをご紹介しました。

JavaScriptの非同期処理（Promiseやasync/await）は、単にデータを裏側で取得するだけでなく、今回のような「ユーザー体験を向上させるためのUI制御」にも非常に有効です。

処理スピードが速いのはもちろん良いことですが、「ユーザーの目にどう映るか」「不安にさせないか」という視点を持ち、自然で心地よいWebサイトを作れるようにこれからも工夫していきたいと思います！

Prev
Next

関連記事