Llama a otra dirección con AJAX() desde el servidor

Total.js 5 · total5@0.0.19 httprequestsajax Ejecutada con Total.js 5

AJAX('METHOD url', [data], [callback]) hace una petición HTTP y te da la respuesta interpretada. Es la forma corta de REQUEST() para APIs que hablan JSON: la misma llamada que tiene jComponent en el navegador, de modo que el código de la página y el del servidor se parecen.

La dirección empieza con un método opcional: AJAX('POST [https://example.com/api/'](https://example.com/api/'), data). Sin método es un GET.
data, cuando se da, se envía como cuerpo JSON. La petición lleva la cabecera x-requested-with: XMLHttpRequest, así que al otro lado $.xhr es true.
La respuesta se interpreta según su tipo de contenido: JSON se convierte en un objeto, application/x-www-form-urlencoded se convierte en un objeto y cualquier otra cosa llega como texto.
Cuando el estado es 400 o más, la promesa se rechaza (o el callback recibe primero el error) con el cuerpo interpretado de la respuesta como error. Un callback se llama como callback(err, value, response).
Sin callback devuelve una promesa.

Para respuestas XML usa REQUEST() y analiza tú el cuerpo: AJAX() está pensado para respuestas JSON y de texto.

El ejemplo llama a rutas de la misma aplicación, cuya dirección da $.hostname('/'), de modo que no necesita ningún otro servidor.

controllers/calls.js

exports.install = function() {
	ROUTE('GET /api/hello/', hello);
	ROUTE('POST /api/echo/', echo);
	ROUTE('GET /api/text/', text);
	ROUTE('GET /api/xml/', xml);
	ROUTE('GET /api/fail/', fail);
	ROUTE('GET /calls/', calls);
};

function hello($) {
	$.json({ hello: 'world', xhr: $.xhr });
}

function echo($) {
	$.json({ received: $.body, xhr: $.xhr });
}

function text($) {
	$.plain('plain text');
}

function xml($) {
	$.xml('<a><b>1</b></a>');
}

function fail($) {
	$.invalid('It is wrong');
}

async function calls($) {

	const base = $.hostname('/');
	const out = {};

	out.hello = await AJAX('GET ' + base + 'api/hello/');
	out.nomethod = await AJAX(base + 'api/hello/');
	out.echo = await AJAX('POST ' + base + 'api/echo/', { a: 1 });
	out.text = await AJAX(base + 'api/text/');

	try {
		await AJAX(base + 'api/fail/');
	} catch (err) {
		out.error = err.message || err;
	}

	out.callback = await new Promise(resolve => AJAX(base + 'api/hello/', (err, value, response) => resolve({ err: err, hello: value.hello, status: response.status })));

	out.xml = await Promise.race([
		AJAX(base + 'api/xml/').then(() => 'answered', () => 'rejected'),
		new Promise(resolve => setTimeout(() => resolve('never answered'), 1000))
	]);

	$.json(out);
}