【JavaScript】タイマー処理の基本!setTimeout と setInterval の使い方と注意点まとめ
JavaScriptで「数秒後にメッセージを表示したい」「一定間隔でカウントアップしたい」といった時間に関わる処理(タイマー処理)を行う際に使われるのが、setTimeout() と setInterval() です。
どちらも時間を指定して関数を実行するメソッドですが、「1回だけ実行するか、繰り返し実行するか」という違いがあります。また、使う際には「タイマーを正しく止める方法」や「ボタン連打による多重起動(バグ)を防ぐ書き方」を知っておくことが重要です。
今回は、2つのメソッドの基本的な使い方から、よく使われる定番テクニックまでをデモと一緒に分かりやすく解説します!
デモ動作
See the Pen JSのタイマー処理!setTimeoutとsetIntervalの基本 by mikanbako (@mikanbako) on CodePen.
demo: setTimeoutとsetIntervalの基本
実装コード紹介
【HTML】
<div class="l-wrap">
<h2>setTimeout & setInterval 比較デモ</h2>
<p class="p-desc">「1回だけ実行」と「繰り返し実行」の動きと、タイマーの止め方を試してみよう!</p>
<div class="p-demo-box">
<!-- 💡 デモ1:setTimeout(一定時間後に1回だけ実行) -->
<section class="p-section">
<h3 class="c-sec-title">① setTimeout:3秒後にメッセージを表示</h3>
<div class="c-status-box js-timeout-box">ボタンを押すとタイマーがセットされます</div>
<div class="c-btn-group">
<button class="c-btn c-btn--primary js-timeout-start">⏱️ 3秒後に表示を予約</button>
<button class="c-btn c-btn--cancel js-timeout-cancel">✖ 予約をキャンセル (clearTimeout)</button>
</div>
</section>
<!-- 💡 デモ2:setInterval(一定間隔ごとに繰り返し実行) -->
<section class="p-section">
<h3 class="c-sec-title">② setInterval:1秒ごとにカウントアップ</h3>
<div class="c-counter"><span class="js-interval-count">0</span> 秒</div>
<div class="c-btn-group">
<button class="c-btn c-btn--start js-interval-start">▶ スタート</button>
<button class="c-btn c-btn--stop js-interval-stop">⏸ ストップ (clearInterval)</button>
<button class="c-btn c-btn--reset js-interval-reset">🔄 リセット</button>
</div>
</section>
</div>
</div>
【CSS】
/* ベース装飾 */
.l-wrap {
padding: 40px 20px;
max-width: 600px;
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;
}
/* デモ1:ステータス表示ボックス */
.c-status-box {
padding: 15px;
margin-bottom: 15px;
font-size: 16px;
font-weight: bold;
color: #666;
text-align: center;
background: #fff;
border: 2px dashed #ccc;
border-radius: 6px;
transition: 0.3s;
}
.c-status-box.is-waiting {
color: #d39e00;
background: #fffdf5;
border-color: #ffc107;
}
.c-status-box.is-done {
color: #e83e8c;
background: #ffe4e1;
border-color: #e83e8c;
transform: scale(1.02);
}
/* デモ2:カウンター表示 */
.c-counter {
padding: 15px;
margin-bottom: 15px;
font-size: 22px;
font-weight: bold;
color: #00838f;
text-align: center;
background: #e0f7fa;
border: 2px solid #1bb4d4;
border-radius: 6px;
}
.c-counter span {
font-family: monospace;
font-size: 32px;
color: #e83e8c;
}
/* ボタングループ */
.c-btn-group {
display: flex;
flex-wrap: wrap;
gap: 10px;
justify-content: center;
}
.c-btn {
padding: 10px 16px;
font-size: 14px;
font-weight: bold;
color: #fff;
cursor: pointer;
border-radius: 6px;
transition: 0.2s;
}
.c-btn:hover {
opacity: 0.85;
transform: translateY(-2px);
}
.c-btn--primary {
background: #e83e8c;
}
.c-btn--cancel {
background: #6c757d;
}
.c-btn--start {
background: #28a745;
}
.c-btn--stop {
background: #fd7e14;
}
.c-btn--reset {
background: #6c757d;
}
【JavaScript】
// =========================================
// 💡 1. setTimeout のデモ処理
// =========================================
const timeoutBox = document.querySelector('.js-timeout-box');
const timeoutStartBtn = document.querySelector('.js-timeout-start');
const timeoutCancelBtn = document.querySelector('.js-timeout-cancel');
// タイマーのID(予約番号)を保存するための変数
let timeoutId = null;
timeoutStartBtn.addEventListener('click', () => {
// すでに予約がある場合は一度キャンセルしてリセット(連打対策)
clearTimeout(timeoutId);
timeoutBox.textContent = '⏳ 3秒後にメッセージが表示されます...';
timeoutBox.className = 'c-status-box is-waiting';
// 3000ミリ秒(3秒)後に1回だけ実行するタイマーをセットし、IDを保存
timeoutId = setTimeout(() => {
timeoutBox.textContent = '🎉 3秒経過しました!処理完了!';
timeoutBox.className = 'c-status-box is-done';
timeoutId = null;
}, 3000);
});
// キャンセルボタンの処理
timeoutCancelBtn.addEventListener('click', () => {
if (timeoutId !== null) {
// 保存しておいたIDを使ってタイマーの予約を取り消す
clearTimeout(timeoutId);
timeoutId = null;
timeoutBox.textContent = '🚫 タイマーの予約をキャンセルしました';
timeoutBox.className = 'c-status-box';
}
});
// =========================================
// 💡 2. setInterval のデモ処理
// =========================================
const countDisplay = document.querySelector('.js-interval-count');
const intervalStartBtn = document.querySelector('.js-interval-start');
const intervalStopBtn = document.querySelector('.js-interval-stop');
const intervalResetBtn = document.querySelector('.js-interval-reset');
let count = 0;
let intervalId = null; // 繰り返しタイマーのIDを保存する変数
intervalStartBtn.addEventListener('click', () => {
// ⚠️ 重要:すでにタイマーが動いている場合は何もしない(多重起動の防止)
if (intervalId !== null) return;
// 1000ミリ秒(1秒)ごとに繰り返し実行する
intervalId = setInterval(() => {
count++;
countDisplay.textContent = count;
}, 1000);
});
// ストップボタンの処理
intervalStopBtn.addEventListener('click', () => {
// 保存しておいたIDを使って繰り返し処理を止める
clearInterval(intervalId);
intervalId = null; // 再開できるように変数を空(null)に戻しておく
});
// リセットボタンの処理
intervalResetBtn.addEventListener('click', () => {
clearInterval(intervalId);
intervalId = null;
count = 0;
countDisplay.textContent = count;
});
コード解説・基本の使い方
2つのメソッドの基本構文と違い
どちらも第1引数に「実行したい関数」、第2引数に「時間(ミリ秒:1000 = 1秒)」を指定します。
setTimeout(関数, ミリ秒)
指定した時間が経過した後に、「1回だけ」関数を実行します。(用途:ポップアップを数秒後に自動で消す、アニメーションの時間差発火など)setInterval(関数, ミリ秒)
指定した時間ごとに、「繰り返し何度も」関数を実行し続けます。(用途:スライドショーの自動再生、時計やカウントダウンタイマーなど)
鉄則①:タイマーを止めるには「タイマーID(返り値)」を使う!
setTimeout や setInterval を実行すると、返り値として「タイマーID(予約番号のような数値)」が返ってきます。 途中で予約を取り消したい時や、繰り返し処理をストップしたい時は、このIDを変数に保存しておき、clearTimeout(ID) または clearInterval(ID) に渡すことで停止させます。
// 1. 返り値(タイマーID)を変数に受け取っておく
const timerId = setInterval(() => {
console.log('1秒ごとに実行中...');
}, 1000);
// 2. 止めたいタイミングで clearInterval にIDを渡す
clearInterval(timerId);
特に setInterval() は、明示的に clearInterval() で止めない限り、ページを閉じるまで裏側で永遠に動き続けてメモリを消費してしまうため、不要になったら必ず止める習慣をつけましょう!
鉄則②:ボタン連打による「多重起動バグ」を防ぐ!
初心者が最も陥りやすいミスとして、スタートボタンを何回も連打された時に、裏側で setInterval が2個も3個も同時に起動してしまい、「カウントアップが倍速でおかしくなる&ストップボタンを押しても止まらない」というバグです。
これを防ぐためには、デモのコードのように以下のどちらかの対策を必ず入れます。
setIntervalの場合if (intervalId !== null) return;のように、「すでにタイマーが動いている(IDが入っている)なら処理をスキップする」という処理を入れ、ストップした時にintervalId = null;に戻す。setTimeoutの場合
新しくsetTimeoutをセットする直前にclearTimeout(timeoutId);を実行し、古い予約を毎回リセット(上書き)する。
応用テクニック:setTimeout を活用した「デバウンス(Debounce)」
「古い予約を毎回キャンセルして、新しく予約し直す」という setTimeout の仕組みを応用したテクニックに「デバウンス(処理の間引き)」があります。
【JavaScript】イベントの連続発火を防ぐ!「デバウンス(Debounce)」の仕組みと比較デモ
例えば、ウィンドウのリサイズイベント(resize)や検索窓の文字入力(input)は、操作中に何十回も連続で発火してしまいます。そこに以下のコードを使うと、「操作が止まってから0.3秒後に1回だけ重い処理を実行する」というスマートな制御が可能になります!
let resizeTimer = null;
window.addEventListener('resize', () => {
// リサイズ中は前回の予約をキャンセルし続ける
clearTimeout(resizeTimer);
// リサイズの操作が止まってから300ミリ秒後に1回だけ実行される!
resizeTimer = setTimeout(() => {
console.log('リサイズ完了!レイアウトを再計算します');
}, 300);
});
補足:公式ドキュメント
まとめ
今回はJavaScriptのタイマー処理である setTimeout() と setInterval() について解説しました。
- 一定時間後に1回だけ実行するなら
setTimeout()(止める時はclearTimeout()) - 一定間隔で繰り返し実行するなら
setInterval()(止める時はclearInterval())
単発で動かすだけなら非常にシンプルなメソッドですが、Web制作時に使う際は「タイマーIDを変数で管理して止められるようにすること」や「連打による多重起動を防ぐこと」がコードを書くための重要なポイントになります。応用で紹介したデバウンス処理も様々な場面で役立つので、ぜひセットで覚えて活用してみてください!