Debounce hangi problemi çözer?
Debounce, yakın zamanlı çağrıları gruplayarak bir işin ne zaman başlatılacağını düzenler. Arama alanında her harften sonra çalışmak yerine son girişten sonra kısa bir sessizlik beklenebilir. MDN debounce açıklaması, leading ve trailing uçları ayırır.
Bu yazıdaki yardımcı yalnızca trailing davranışı uygular: son çağrıdan sonra bekleme süresi dolunca bir kez çalışır. İlk çağrıyı hemen çalıştırmaz, kesintisiz çağrılarda azami bekleme süresi de koymaz. Bu seçimleri adı debounce olduğu için bütün uygulamalarda aynı kabul etmeyin.
Küçük ve iptal edilebilir bir yardımcı nasıl yazılır?
Her çağrı önceki zamanlayıcıyı kaldırır ve son argümanlarla yeni bir tane kurar. Callback çağrılmadan önce zamanlayıcı durumu temizlenir:
function debounce(fn, delay = 300) {
if (typeof fn !== 'function') throw new TypeError('A function is required');
if (!Number.isInteger(delay) || delay < 0 || delay > 2_147_483_647) {
throw new RangeError('Unsupported delay');
}
let timer;
function debounced(...args) {
clearTimeout(timer);
const receiver = this;
timer = setTimeout(() => {
timer = undefined;
fn.apply(receiver, args);
}, delay);
}
debounced.cancel = () => {
clearTimeout(timer);
timer = undefined;
};
return debounced;
}
const search = debounce(value => console.log(value), 250);
search('r');
search('re');
search('react');
Bu üç çağrı arasında süre ilerlemediği için örnekte yalnızca react çalışır. 250 milisaniye bir örnek tercihtir; bütün arama alanları için ideal bir değer olduğu iddia edilmez. Yardımcının gecikme doğrulaması da bu uygulamanın sözleşmesidir, bütün debounce kütüphanelerinin ortak kuralı değildir.
setTimeout başvurusu, belirtilen gecikmenin kesin çalışma anını garanti etmediğini açıklar. Yoğun ana iş parçacığı veya arka plan sekmesi daha geç çalışmaya yol açabilir. Sıfır gecikme de callback'in aynı satırda hemen çalışması demek değildir.
Son argüman ve this neden korunur?
Arama için genellikle en yeni değer gerekir. Önceki çağrıların argümanlarını biriktirmek, debounce yerine başka bir kuyruk sözleşmesi oluşturur. Yardımcı, son çağrının argümanlarını ve çağıran nesne bağlamını callback'e taşır.
Bu nedenle nesne metodu üzerinden çağrıldığında fn.apply(receiver, args) anlamlıdır. Arrow fonksiyonların kendi this davranışı ise değişmez. Bu yardımcı callback'in sonucunu taşıyan bir Promise döndürmez; asenkron sonuçların ve hataların yönetimi callback'i kullanan kodun sorumluluğundadır.
Arama girdisine nasıl bağlanır?
Aşağıdaki örnek gerçek bir sunucu sorgusu yapmaz; hangi ifadenin aranacağını durum alanında gösterir. Böylece zamanlama davranışını ağdan bağımsız gözlemleyebilirsiniz:
<label for="search-term">Yazı ara</label>
<input id="search-term" type="search">
<p id="search-status" role="status"></p>
Önceki yardımcıyla birlikte, HTML'den sonra şu kodu çalıştırın:
const input = document.querySelector('#search-term');
const status = document.querySelector('#search-status');
const scheduleSearch = debounce(value => {
status.textContent = 'Aranacak ifade: ' + value;
}, 250);
function handleInput(event) {
const value = event.currentTarget.value.trim();
if (!value) {
scheduleSearch.cancel();
status.textContent = '';
return;
}
scheduleSearch(value);
}
input.addEventListener('input', handleInput);
function disposeSearch() {
input.removeEventListener('input', handleInput);
scheduleSearch.cancel();
}
Değer, olay işlenirken metin olarak alınır. Girdi boşaltıldığında bekleyen iş iptal edilir ve eski arama etiketi temizlenir. Ekran kaldırılırken disposeSearch çağrılması hem dinleyiciyi hem bekleyen zamanlayıcıyı temizler.
cancel devam eden isteği durdurur mu?
Hayır. clearTimeout henüz çalışmamış zamanlayıcıyı kaldırır. Callback başlayıp bir ağ isteği oluşturduysa cancel onu geri almaz. Bekleyen işi iptal etmek, başlamış işi durdurmak ve eski bir yanıtın yeni sonucu ezmesini önlemek farklı sorunlardır.
AbortController ve yarış koşulları rehberi, istek başladıktan sonraki yaşam döngüsünü ele alır. Debounce, bu mekanizmaların yerine geçmez; yalnızca gereksiz işin başlamasını azaltabilir.
Throttle ile aynı araç mı?
Hayır. Throttle, belirli bir sıklık sınırıyla çalışmayı düzenlerken bu trailing debounce sessizlik bekler. Sürekli giriş geldiğinde burada callback sürekli ertelenebilir. Düzenli ara güncellemeler gerekiyorsa farklı bir zamanlama sözleşmesi gerekir.
Testte son argümanı, çağıran nesneyi, bekleme eşiğini ve iptali ayrı ayrı kontrol edin. Gerçek saatle yalnızca uzun beklemeler yapmak yerine kontrollü bir zamanlayıcı düzeneği kullanmak, sınır durumlarını daha açık görmeyi sağlar. Yine de örneği gerçek tarayıcı girdisi ve ekran temizliğiyle de deneyin.
Sık sorulan sorular
Bu yardımcı ilk çağrıyı hemen çalıştırır mı? Hayır. Yalnızca trailing uçta çalışır.
cancel eski HTTP yanıtını engeller mi? Hayır. Başlamış istek ve sonuç sırası ayrı yönetilmelidir.
Bütün alanlarda 250 ms kullanılmalı mı? Hayır. Gecikme, ürün ihtiyacı ve etkileşim deneyimiyle belirlenir.

