Opóźniaj pracę za pomocą setTimeout2() i clearTimeout2()
setTimeout2(id, callback, timeout) to setTimeout z nazwą. Gdy wywołasz go ponownie z tym samym id przed upływem czasu, poprzedni timer zostaje anulowany i zastąpiony: callback uruchamia się raz, po ustaniu wywołań. To zwykły sposób, by zapisać, przeładować lub przeliczyć tylko raz, gdy naraz napływa wiele zdarzeń (seria zmian, pisanie, lawina wiadomości).
clearTimeout2(id) anuluje timer o tym id i zwraca true, gdy jakiś był, a false, gdy go nie było.
Pełna postać to setTimeout2(id, callback, timeout, limit, a, b, c, d, e): wartości po limit są przekazywane do callbacku. Nie używaj limit w total5 0.0.19: pomysł polega na natychmiastowym uruchomieniu callbacku po limit zastąpieniach, ale licznik nigdy się nie zaczyna (jest undefined i staje się NaN), więc callback jest wywoływany dopiero po upływie czasu. Przykład wywołuje go dziesięć razy z limitem 3, a callback nie uruchomił się wcześniej.
exports.install = function() {
ROUTE('GET /burst/', burst);
};
async function burst($) {
const log = [];
// three calls with the same id: only the last one runs
setTimeout2('save', () => log.push('first'), 100);
setTimeout2('save', () => log.push('second'), 100);
setTimeout2('save', () => log.push('third'), 100);
// a timer that is cancelled before it runs
setTimeout2('gone', () => log.push('gone'), 100);
const cancelled = clearTimeout2('gone');
const nothing = clearTimeout2('never-set');
// the values after the limit reach the callback
setTimeout2('args', (a, b) => log.push(a + b), 50, 0, 'x', 'y');
// the limit option does not run the callback early
let early = 0;
for (let i = 0; i < 10; i++)
setTimeout2('limited', () => early++, 1000, 3);
const stopped = clearTimeout2('limited');
await new Promise(resolve => setTimeout(resolve, 300));
$.json({ log: log, cancelled: cancelled, nothing: nothing, early: early, stopped: stopped });
}