Як використовувати jQuery функцію $.ajax()

Іноді, нам потрібно більше контролю над Ajax-запитами, які ми виконуємо. Наприклад, ми хочемо вказати, що має відбуватися у випадку, коли Ajax-виклик не вдався, або нам потрібно виконати Ajax-запит, але результат потрібен тільки тоді, коли він отриманий за певну кількість часу. У таких ситуаціях ми можемо розраховувати на jQuery функцію $.ajax(). Це і буде темою сьогоднішньої статті.

$.ajax() функція

В jQuery $.ajax() функція використовується для виконання асинхронного запиту HTTP. Вона була додана в бібліотеку давно, присутня з версії 1.0. Параметри цієї функції показано нижче:

    $.ajax(url[, options])
    $.ajax([options])

Параметр url \- це рядок, що містить URL, який ви хочете досягти з допомогою Ajax-запиту, а options \- це об'єкт, що містить налаштування для Ajax-запиту.

В своїй першій формі, функція виконує Ajax-запит за допомогою параметра url і параметрів, зазначених в налаштуваннях. У другій формі, URL, зазначений у параметрі options, може бути пропущений, у цьому випадку, запит виконується до поточної сторінки.

Перелік опцій цієї функції дуже довгий. Тож ми будемо намагатися скоротити опис. У разі, якщо ви хочете поглиблено вивчати їх сенс, ви можете звернутися до офіційної документації $.ajax().

Параметр option

Є багато варіантів опцій для $.ajax (). У списку нижче, Ви можете знайти їх імена і опис в алфавітному порядку:

• accepts: Тип вмісту, відправляється в заголовку запиту. Вказує серверу, яку відповідь він буде приймати по поверненню.

• async: встановіть значення false, щоб виконати синхронний запит.

• beforeSend: pre-request функції зворотного виклику, який може бути використаний, щоб змінити об'єкт jqXHR перед відправкою.

• cache: встановіть опції значення false, щоб змусити запитувані сторінки не кешуватися браузером.

• complete: функція викликається, коли закінчується запит (після success і _error _виконуються зворотні виклики).

• contents: об'єкт, який визначає, яка бібліотека буде аналізувати відповідь.

• contentType: тип вмісту, що відправляється на сервер.

• context: об'єкт для використання в якості контексту для всіх Ajax-пов'язаних зворотніх викликів.

• converters: об'єкт, що містить "тип даних в тип даних" для перетворювачів.

• crossDomain: встановити цю властивість в true для кросдоменного запиту (наприклад, JSONP) на тому ж домені.

• data: дані для відправки на сервер при виконанні Ajax-запиту.

• dataFilter: функція використовується для обробки raw-даних XMLHttpRequest.

• dataType: тип очікуваних даних з сервера.

• error: функція, яка буде викликана, якщо запит не буде виконано.

• global: Надати можливість викликати глобальні обробники подій Ajax для цього запиту.

• headers: додаткові заголовки для відправки на сервер.

• ifModified: встановіть цей параметр як true, якщо ви хочете вважати запит успішним лише у випадку, якщо відповідь змінилася з моменту останнього запиту.

• isLocal: встановіть цей параметр як true, якщо ви хочете змусити jQuery визнати поточне середовище локальним.

• jsonp: рядок для зміни імені функції зворотного виклику в JSONP запиті.

• jsonpCallback: задає ім'я функції зворотного виклику для JSONP запиту.

• mimeType: рядок, який вказує тип mime для перевизначення XHR mime.

• password: пароль з XMLHttpRequest у відповідь на запит HTTP аутентифікації.

• processData: встановіть цей параметр як false, якщо Ви не хочете, щоб дані в опції data (якщо вони не є рядком) були оброблені і перетворені в рядок запиту.

• scriptCharset: встановлює атрибут charset для тегуі script, що використовується в запиті, але застосовується тільки тоді, коли відбувається транспортування сценарію.

• statusCode: об'єкт числових кодів HTTP і функції, що викликаються при відповіді на відповідний код.

• success: функція, яка буде викликана, якщо запит успішно виконано.

• timeout: число, яке задає час очікування (в мілісекундах) для запиту.

• traditional: встановити як true, якщо ви хочете використовувати традиційний стиль для сериалізації параметрів.

• type: тип запиту, який може бути або "POST" або "GET".

• url: рядок, що містить URL-адресу, на яку надсилається запит.

• username: ім'я користувача для використання з XMLHttpRequest у відповідь на запит HTTP аутентифікації.

• xhr: зворотний виклик для створення об'єкта XMLHttpRequest.

• xhrFields: об'єкт, щоб встановити нативний XHR об'єкт.