Отлагайте работа със setTimeout2() и clearTimeout2()

Total.js 5 · total5@0.0.19 timersdebounceutilities Изпълнено с Total.js 5

setTimeout2(id, callback, timeout) е setTimeout с име. Когато го извикате отново със същото id, преди да е изтекло времето, предишният таймер се отменя и се заменя: callback се изпълнява веднъж, след като извикванията спрат. Това е обичайният начин да запишете, презаредите или преизчислите само веднъж, когато много събития идват заедно (серия от промени, писане, порой от съобщения).

clearTimeout2(id) отменя таймера на това id и връща true, когато е имало такъв, и false, когато не е имало.

Пълният вид е setTimeout2(id, callback, timeout, limit, a, b, c, d, e): стойностите след limit се предават на callback. Не използвайте limit в total5 0.0.19: идеята е callback да се изпълни веднага след limit замествания, но броячът никога не стартира (той е undefined и става NaN), така че callback се извиква само когато времето изтече. Примерът го извиква десет пъти с лимит 3 и callback не се изпълни по-рано.

controllers/timers.js

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 });
}