Testar a aplicação com o executor de testes incorporado

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

O Total.js tem um pequeno executor de testes, total5/test. Um ficheiro de teste é um script Total.js normal: carrega o framework e o executor, inicia a aplicação e, quando está ready, regista os seus testes. Test.push(name, fn) acrescenta um teste; fn(next) faz o seu trabalho e chama next() para continuar com o seguinte. Test.print(message, error) reporta uma verificação: passe null como error em caso de sucesso (imprime-se [OK]) ou uma mensagem em caso de falha (imprime-se [FAIL] e o processo termina com código 1). Test.run() executa os testes registados por ordem e termina com código 0 no fim.

Como uma falha termina o processo com um código diferente de zero, o ficheiro pode ser chamado por npm test e por qualquer serviço de CI. Espere um momento (cerca de 500 ms) depois de ready antes do primeiro pedido: um pedido enviado de imediato ainda pode receber um 404. Use RESTBuilder (ou REQUEST) contra o servidor local para testar rotas e chame as ações diretamente com ACTION().

controllers/sum.js

exports.install = function() {
	ROUTE('GET /sum/{a}/{b}/', sum);
	ROUTE('GET /dir/', dir);
};

function sum($) {
	$.json({ total: +$.params.a + +$.params.b });
}

function dir($) {
	$.json({ dir: PATH.root() });
}

test.js

require('total5');
require('total5/test');

// Another port than the application uses, so both can run
Total.run({ port: 8765, release: false, watcher: false });

ON('ready', function() {

	// A request sent in the same tick as "ready" can still get a 404, so give the routes a moment
	setTimeout(runtests, 500);
});

function runtests() {

	Test.push('The sum route', function(next) {
		RESTBuilder.GET('http://127.0.0.1:8765/sum/2/3/').exec(function(err, response) {
			Test.print('2 + 3 = 5', response && response.total === 5 ? null : 'Expected 5, got ' + JSON.stringify(response));
			next();
		});
	});

	Test.push('Unknown route', function(next) {
		RESTBuilder.GET('http://127.0.0.1:8765/missing/').exec(function(err, response, output) {
			Test.print('/missing/ answers 404', output.status === 404 ? null : 'Expected 404, got ' + output.status);
			next();
		});
	});

	Test.run();
}