ForgeTotal.js 5
pt

Total.js 5

Executar código segundo um agendamento com CRON

Total.js 5 · total5@0.0.19 cronschedulerjobs Executada com o Total.js 5

CRON(line, fn) executa fn(date) sempre que a hora atual corresponde a line. A linha tem cinco campos, como no cron do Unix: minute hour day-of-month month day-of-week. Cada campo aceita * (qualquer valor), 1,5,9 (uma lista), 1-5 (um intervalo) ou um número exato. Os nomes de dia como mon ou fri funcionam no último campo.

Escreva os valores como uma lista, 0,15,30,45: corresponde exatamente às horas que indica.

O Total.js verifica as tarefas registadas uma vez por minuto, pelo que a resolução mais fina é um minuto. CRON() devolve um objeto: job.remove() cancela o registo e job.check(date) diz-lhe se uma data corresponde à linha, o que é também a forma mais fácil de testar um agendamento sem esperar.

controllers/cron.js
exports.install = function() {
	ROUTE('GET /cron/matches/', matches);
	ROUTE('GET /cron/runs/', runs);
};

var counter = { runs: 0 };

// Every 15 minutes, from Monday to Friday, between 09:00 and 17:59
var job = CRON('0,15,30,45 9-17 * * 1-5', function(date) {
	counter.runs++;
});

function matches($) {

	var dates = {
		monday_0930: new Date(2026, 0, 5, 9, 30),
		monday_0931: new Date(2026, 0, 5, 9, 31),
		monday_1830: new Date(2026, 0, 5, 18, 30),
		sunday_0930: new Date(2026, 0, 4, 9, 30)
	};

	var output = {};
	for (var key in dates)
		output[key] = job.check(dates[key]);

	$.json(output);
}

function runs($) {
	$.json(counter);
}