English | 简体中文 | 繁體中文 | Русский язык | Français | Español | Português | Deutsch | 日本語 | 한국어 | Italiano | بالعربية

jQuery ajax() 方法

Методы AJAX jQuery

$ .ajax()方法执行异步HTTP(Ajax)请求。

$.ajax() метод является основой для всех Ajax-запросов jQuery. Обычно не нужно напрямую вызывать этот метод, так как можно использовать$.get(),$.post()иload()и несколько других более сложных альтернатив, которые легче использовать. Однако, если нужно меньше обычных опций, $.ajax() можно использовать более гибко.

Грамматика:

Грамматика之一:Версия 1.5+

$.ajax(url, {name:value, name:value, ...})

Грамматика之二 :1.0+Версия:

$.ajax(name:value, name:value, ...)

Пример

ИспользуяДобавитьAJAX запросаВерсияИзменение текста элемента DIV:Версия 1.5

$.ajax("ajax_intro.txt", {success: function(response){
  $("div").html(response);
});
Проверьте, посмотрите < / >

ИспользуяДобавитьAJAX запросаВерсияИзменение текста элемента DIV:1.0Версия:

$.ajax({
  url: "ajax_intro.txt",
  success: function(response){
    $("div").html(response);
  }
});
Проверьте, посмотрите < / >

Запрос на страницу "ajax_get.php" и отправка некоторых других данных:

$.ajax({
  url: "ajax_get.php",
  data: {fname:"Seagull", lname:"Anna"},
  success: function(response){
    $("div").html(response);
  }
});
Проверьте, посмотрите < / >

Запрос на страницу "ajax_get.php", отправка некоторых других данных и отображение сообщения о статусе:

$.ajax({
  url: "ajax_get.php",
  data: {fname:"Seagull", lname:"Anna"},
  success: function(response, status){
        $("div").html(response);
        alert(status);
  }
});
Проверьте, посмотрите < / >

Запрос на страницу "ajax_post.php" через HTTP POST метод:

$.ajax({
  url: "ajax_post.php",
  method: "POST",
  success: function(response){
        $("div").html(response);
  }
});
Проверьте, посмотрите < / >

Использование параметра асинхронности для指定 синхронного запроса:

$.ajax({
  url: "ajax_get.php",
  async: false,
  data: {fname:"Seagull", lname:"Anna"},
  success: function(response){
        $("div").html(response);
  }
});
Проверьте, посмотрите < / >

Использование параметра dataType для запроса указанного типа данных:

$.ajax({
  url: "/javascript/myscript.js",
  dataType: "script"
});
Проверьте, посмотрите < / >

Если Ajax-запрос встречает ошибку, будет отображено уведомление:

$.ajax({
  url: "wrong_file.html",
  success: function(response){
        $("div").html(response);
  },
  error: function(xhr){
        $("div").html("Ошибка: " + xhr.status + " " + xhr.statusText);
  }
});
Проверьте, посмотрите < / >

Запрос файла и уведомление пользователя по завершении. Если запрос失败, будет отображено уведомление:

let request = $.ajax({
  url: "ajax_get.php",
  data: {fname:"Seagull", lname:"Anna"}
});
request.done(function(msg){
  $("div").html(msg);
});
request.fail(function(xhr, textStatus){
  $("div").html("Запрос не удался: " + textStatus);
});
Проверьте, посмотрите < / >

Значение параметра

Параметр указывает один или несколько name:value пар для AJAX-запроса.

Возможные имена: значения в таблице ниже:

ИмяТип значенияОписание
asyncБулевоБулевое значение, указывающее, следует ли обрабатывать запрос асинхронно. По умолчанию установлено в true
beforeSend(xhr)ФункцияФункция, выполняемая перед отправкой запроса
cacheБулевоБулевое значение, указывающее, следует ли браузеру кэшировать запрашиваемую страницу. По умолчанию установлено в true
complete(xhr,status)ФункцияФункция, выполняемая после завершения запроса (после успешной и ошибочной функции)
contentTypeБулево значение или строкаТип содержимого, используемый при отправке данных на сервер. По умолчанию установлено в “application / x-www-form-urlencoded”
contextОбычный объектУказание значения this для всех回调-функций, связанных с AJAX
dataPlainObject или String или ArrayУказание данных, которые следует отправить на сервер
dataFilter(data,type)ФункцияФункция, используемая для обработки исходных данных XMLHttpRequest
dataTypeСтрокаТип данных, ожидаемый в ответе сервера
error(xhr,status,error)ФункцияФункция, выполняемая при失败 запроса
globalБулевоБулевое значение, указывающее, следует ли вызывать глобальный обработчик событий AJAX для запроса. По умолчанию установлено в true
ifModifiedБулевоБулевое значение, указывающее, следует ли считывать запрос успешным только в том случае, если ответ с последнего запроса изменился. По умолчанию установлено в false.
jsonpСтрока или булево значениеПерекрытие функции回调 jsonp-запросов
jsonpCallbackФункцияУказание имени функции回调 для jsonp-запросов
methodСтрокаУказание HTTP-метода, используемого для запроса. (Получение или发布). По умолчанию установлено в GET
passwordСтрокаУказание пароля, используемого для запроса аутентификации HTTP.
processDataБулевоБулевое значение, указывающее, следует ли преобразовывать данные, отправляемые вместе с запросом, в строку запроса.По умолчанию установлено в true
scriptCharsetСтрокаУказать код набора символов запроса
statusCodeОбычный объектОбъект, который вызывается при наличии соответствующего кода ответа, содержит цифровой код HTTP и функцию
$.ajax({
  statusCode: {
    404: function() {
      alert(“Невозможно найти страницу”);
    }
  }
)
success(response,status,xhr)ФункцияФункция, которая должна быть выполнена при успешном выполнении запроса
timeoutЧислоЛокальное время ожидания запроса (в миллисекундах)
traditionalБулевоБулево значение, определяющее следует ли использовать традиционную последовательность параметров
typeСтрокаmethodАльтернативное имя. Если вы используете версию jQuery 1.9.0 или более раннюю, используйте type
urlСтрокаУказать URL, на который будет отправлен запрос. По умолчанию это текущая страница
usernameСтрокаУказать имя пользователя, которое должно использоваться в запросах аутентификации HTTP
xhrФункцияФункция для создания объекта XMLHttpRequest

Методы AJAX jQuery