debounce

Antirrebote: cuando una función se dispara muchas veces seguidas, se ejecuta solo cuando los disparos cesan durante ms milisegundos. Úsalo cuando lo único que importa es el estado final: buscar mientras se escribe, redimensionar la ventana, guardar solo.

Si necesitas también los valores intermedios, usa throttle.

API

debounce(fn, ms?)

Parámetros

Parámetro	Descripción	Tipo	Por defecto
`fn`	Función a la que aplicar el antirrebote	`Function`	Obligatorio
`ms`	Tiempo de calma (ms)	`number`	`500`

Devuelve

Una función con antirrebote que conserva el this del punto de llamada y los últimos argumentos, además de:

Miembro	Descripción	Tipo
`cancel()`	Descarta la llamada pendiente	`() => void`
`flush()`	Ejecuta ya la llamada pendiente (antes de enviar, por ejemplo)	`() => void`
`pending()`	Si hay una llamada esperando	`() => boolean`

Ejemplo

import { debounce } from 'ranuts';

const save = debounce((draft) => api.save(draft), 800);
input.addEventListener('input', (e) => save(e.target.value));

form.addEventListener('submit', () => save.flush()); // que no se pierda la última tecla
onUnmount(() => save.cancel());

Notas

Solo se ejecuta la última llamada, con los argumentos de esa última llamada.
El this viene del punto de llamada: obj.handler() ve obj.
Llama siempre a cancel() al desmontar; si no, el temporizador pendiente dispara sobre un contexto ya destruido.
Tipado completo: los tipos de los argumentos y del retorno se infieren de fn.