Volajte inú adresu cez AJAX() zo servera
AJAX('METHOD url', [data], [callback]) vykoná HTTP požiadavku a vráti vám spracovanú odpoveď. Je to krátka forma REQUEST() pre API, ktoré komunikujú v JSON: rovnaké volanie, aké má jComponent v prehliadači, takže kód stránky a servera vyzerajú podobne.
- Adresa začína voliteľnou metódou:
AJAX('POST [https://example.com/api/'](https://example.com/api/'), data). Bez metódy je toGET. data, ak sú zadané, sa odošlú ako JSON telo. Požiadavka nesie hlavičkux-requested-with: XMLHttpRequest, takže na druhej strane je$.xhrrovnétrue.- Odpoveď sa spracuje podľa typu obsahu: JSON sa stane objektom,
application/x-www-form-urlencodedsa stane objektom a všetko ostatné príde ako text. - Keď je stav 400 alebo vyšší, promise sa zamietne (alebo callback dostane najprv chybu) so spracovaným telom odpovede ako chybou. Callback sa volá ako
callback(err, value, response). - Bez callbacku vráti promise.
Pre odpovede XML použite REQUEST() a telo si spracujte sami: AJAX() je určené pre odpovede JSON a text.
Príklad volá routy tej istej aplikácie, ktorých adresu dáva $.hostname('/'), takže nepotrebuje žiadny iný server.
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);
}