Debounce là kỹ thuật trì hoãn việc chạy một hàm cho tới khi sự kiện ngừng kích hoạt trong một khoảng thời gian nhất định. Với ô tìm kiếm, thay vì gọi API sau mỗi ký tự người dùng gõ, bạn bọc hàm gọi API bằng debounce 300ms — API chỉ được gọi khi người dùng ngừng gõ đủ 300ms. Cách này giảm hàng chục request thừa xuống còn một, dùng được cho mọi ô tìm kiếm, bộ lọc và form tự lưu.

Vấn đề

Giả sử ô tìm kiếm gọi API ngay trong sự kiện input. Người dùng gõ “linhfish” — 8 ký tự, 8 request bay đi gần như cùng lúc. Máy chủ phải xử lý 7 request đã lỗi thời, chưa kể request gõ “l” có thể trả về sau request gõ “linhfish” và ghi đè kết quả đúng bằng kết quả sai. Hiện tượng này gọi là race condition ở tầng giao diện, và nó xảy ra với mọi form nhập liệu gọi API trực tiếp: autocomplete, lọc bảng, kiểm tra tên đăng nhập.

searchInput.addEventListener("input", (event) => {
fetch(`/api/search?q=${event.target.value}`)
.then((res) => res.json())
.then(renderResults);
});

Giải pháp

Debounce giải quyết bằng một bộ hẹn giờ duy nhất: mỗi lần sự kiện kích hoạt, hủy hẹn giờ cũ và đặt hẹn giờ mới. Chỉ khi không còn sự kiện nào trong 300ms, hàm mới thực sự chạy. Hàm debounce dưới đây dùng được cho mọi hàm, giữ nguyên this và tham số nhờ …args và apply.

function debounce(fn, delay = 300) {
let timerId;
return function (...args) {
clearTimeout(timerId);
timerId = setTimeout(() => fn.apply(this, args), delay);
};
}
const searchApi = debounce(async (query) => {
const res = await fetch(`/api/search?q=${encodeURIComponent(query)}`);
renderResults(await res.json());
}, 300);
searchInput.addEventListener("input", (event) => {
searchApi(event.target.value.trim());
});

Với đoạn code này, gõ “linhfish” chỉ tạo một request duy nhất sau khi tay rời bàn phím 300ms. Con số 300ms là điểm cân bằng thực tế: ngắn hơn thì vẫn spam request, dài hơn thì người dùng cảm thấy ô tìm kiếm chậm chạp. Nếu muốn phản hồi ngay lần gõ đầu tiên rồi mới debounce các lần sau, hãy thêm tham số leading — lodash.debounce hỗ trợ sẵn.

Áp dụng vào dự án của bạn

Áp dụng ngay vào dự án của bạn: bọc hàm gọi API của ô tìm kiếm, autocomplete và bộ lọc bằng debounce 300ms; dùng 500–1000ms cho tính năng tự lưu nháp. Với sự kiện scroll và resize, debounce không phải lựa chọn đúng — hãy dùng throttle vì bạn cần cập nhật liên tục trong lúc cuộn, không phải chờ cuộn xong. Một lưu ý cuối: debounce chỉ hoãn việc gọi hàm, không hủy request đang bay — nếu kết quả cũ vẫn có thể về muộn, kết hợp thêm AbortController để hủy request trước đó.

Bài viết liên quan

Câu hỏi thường gặp

Debounce khác throttle như thế nào?

Debounce chờ sự kiện ngừng hẳn mới chạy một lần; throttle giới hạn tối đa một lần chạy trong mỗi khoảng thời gian, ví dụ một lần mỗi 200ms. Ô tìm kiếm dùng debounce, còn scroll và resize dùng throttle.

Nên đặt delay bao nhiêu mili-giây?

Tìm kiếm và autocomplete: 200–300ms. Tự lưu nháp: 500–1000ms. Thử với người dùng thật: nếu cảm thấy chậm, giảm 50ms; nếu server vẫn quá tải, tăng 100ms.

Debounce có hủy được request đang bay không?

Không. Debounce chỉ hoãn lúc gọi hàm; request đã gửi đi vẫn chạy. Muốn hủy request cũ, kết hợp AbortController như bài viết về fetch đã hướng dẫn.

Dùng debounce trong React hoặc Vue thế nào?

Bọc hàm debounce trong useMemo (React) hoặc tạo một lần trong setup (Vue) để không tạo hàm mới mỗi lần render — nếu không, timer bị reset liên tục và hàm không bao giờ chạy. Hoặc dùng sẵn lodash.debounce, hàm này có sẵn phương thức cancel và flush.

💬 Bạn đã thử cách này trong dự án của mình chưa? Nếu gặp lỗi hoặc có cách làm gọn hơn, để lại bình luận bên dưới — mình đọc hết và sẽ bổ sung những ý hay vào bài.

Nguồn tham khảo