Anropa en annan adress med AJAX() från servern

Total.js 5 · total5@0.0.19 httprequestsajax Körd med Total.js 5

AJAX('METHOD url', [data], [callback]) gör en HTTP-förfrågan och ger dig det tolkade svaret. Det är den korta formen av REQUEST() för API:er som talar JSON: samma anrop som jComponent har i webbläsaren, så att sidans kod och serverns kod liknar varandra.

Adressen börjar med en valfri metod: AJAX('POST [https://example.com/api/'](https://example.com/api/'), data). Utan metod är det en GET.
data skickas, när det anges, som en JSON-kropp. Förfrågan bär headern x-requested-with: XMLHttpRequest, så på andra sidan är $.xhr true.
Svaret tolkas efter sin innehållstyp: JSON blir ett objekt, application/x-www-form-urlencoded blir ett objekt, allt annat kommer som text.
När statusen är 400 eller högre avvisas löftet (eller så får callbacken felet först) med svarets tolkade kropp som fel. En callback anropas som callback(err, value, response).
Utan callback returnerar den ett löfte.

För XML-svar, använd REQUEST() och tolka innehållet själv: AJAX() är gjort för JSON- och textsvar.

Exemplet anropar routes i samma applikation, vars adress $.hostname('/') ger, så att det inte behöver någon annan server.

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