Іноді, нам потрібно більше контролю над 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 об'єкт.
Ще немає коментарів