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

Método jQuery ajax()

Métodos Ajax de jQuery

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

$.ajax() método para ejecutar solicitudes HTTP (Ajax) asincrónicas.$.ajax() es el método básico que jQuery utiliza para enviar todas las solicitudes Ajax. Generalmente no es necesario llamar directamente a este método, ya que se puede$.get(),$.post()yload()

y varios métodos más avanzados, que son más fáciles de usar. Sin embargo, si se necesitan menos opciones comunes, $.ajax() puede ser más flexible.

Sintaxis::1.5+de la solicitud AJAX:

Sintaxis uno

$.ajax(url, {name:value, name:value, ...}) :1.0+Versión:

Sintaxis dos

Ejemplo

$.ajax("ajax_intro.txt", {success: function(response){UsarAgregarde la solicitud AJAXCambiar el texto del elemento DIV:1.5de la solicitud AJAX:

$.ajax(name:value, name:value, ...)
  $("div").html(response);
});
Prueba y mira‹/›

$.ajax("ajax_intro.txt", {success: function(response){UsarAgregarde la solicitud AJAXCambiar el texto del elemento DIV:1.0Versión:

$.ajax({
  url: "ajax_intro.txt",
  success: function(response){
    $("div").html(response);
  }
});
Prueba y mira‹/›

Solicitar la página "ajax_get.php" y enviar algunos otros datos:

$.ajax({
  url: "ajax_get.php",
  data: {fname:"Seagull", lname:"Anna"},
  success: function(response){
    $("div").html(response);
  }
});
Prueba y mira‹/›

Solicitar la página "ajax_get.php", enviar algunos otros datos y emitir un mensaje de estado de alerta:

$.ajax({
  url: "ajax_get.php",
  data: {fname:"Seagull", lname:"Anna"},
  success: function(response, status){
        $("div").html(response);
        alert(status);
  }
});
Prueba y mira‹/›

Usar el método HTTP POST para solicitar la página "ajax_post.php":

$.ajax({
  url: "ajax_post.php",
  method: "POST",
  success: function(response){
        $("div").html(response);
  }
});
Prueba y mira‹/›

Usar la configuración asíncrona para especificar solicitudes sincrónicas:

$.ajax({
  url: "ajax_get.php",
  async: false,
  data: {fname:"Seagull", lname:"Anna"},
  success: function(response){
        $("div").html(response);
  }
});
Prueba y mira‹/›

Usar dataType para establecer el tipo de datos solicitado:

$.ajax({
  url: ""/javascript/myscript.js",
  dataType: "script"
});
Prueba y mira‹/›

Si la solicitud Ajax encuentra un error, mostrar un aviso:

$.ajax({
  url: "wrong_file.html",
  success: function(response){
        $("div").html(response);
  },
  error: function(xhr){
        $("div").html("Error: " + xhr.status + " " + xhr.statusText);
  }
});
Prueba y mira‹/›

Solicitar un archivo y notificar al usuario una vez completada. Si la solicitud falla, mostrar un aviso:

let request = $.ajax({
  url: "ajax_get.php",
  url: "ajax_get.php",
});
data: {fname:"Seagull", lname:"Anna"}
  request.done(function(msg){
});
$("div").html(msg);
  $("div").html("Request failed: ") + textStatus);
});
Prueba y mira‹/›

Valor de parámetro

Los parámetros especifican uno o más pares name:value para la solicitud AJAX.

Nombres posibles: los valores en la siguiente tabla:

NombreTipo de valorDescripción
asyncBooleanoUn valor booleano que indica si la solicitud debe procesarse de manera asíncrona. El valor predeterminado es true
beforeSend(xhr)FunciónLa función que se ejecuta antes de enviar la solicitud
cacheBooleanoUn valor booleano que indica si el navegador debe cachear la página de la solicitud. El valor predeterminado es true
complete(xhr,status)FunciónLa función que se ejecuta después de que la solicitud se complete (después de las funciones de éxito y error)
contentTypeBooleano o cadenaEl tipo de contenido utilizado para enviar datos al servidor. El valor predeterminado es: 'application' / x-www-form-urlencoded
contextObjeto comúnEspecifica el valor de 'this' para todas las funciones de retroalimentación relacionadas con AJAX
dataPlainObject o String o ArrayEspecifica los datos que se deben enviar al servidor
dataFilter(data,type)FunciónLa función utilizada para procesar los datos originales de la respuesta XMLHttpRequest
dataTypeCadenaEl tipo de datos esperado en la respuesta del servidor
error(xhr,status,error)FunciónLa función que se ejecuta cuando la solicitud falla
globalBooleanoUn valor booleano que especifica si se debe activar el manejador de eventos AJAX global de la solicitud. El valor predeterminado es true
ifModifiedBooleanoUn valor booleano que especifica si la solicitud tiene éxito solo cuando la respuesta desde la última solicitud ha cambiado. El valor predeterminado es: false.
jsonpCadena o booleanoSobrescribe la función de retroalimentación jsonp
jsonpCallbackFunciónEspecifica el nombre de la función de retroalimentación para la solicitud jsonp
methodCadenaEspecifica el método HTTP utilizado para la solicitud. (Obtener o publicar). El valor predeterminado es GET
passwordCadenaEspecifica la contraseña utilizada en la solicitud de autenticación HTTP.
processDataBooleanoUn valor booleano que especifica si debe convertirse los datos enviados con la solicitud en una cadena de consulta. El valor predeterminado es true
scriptCharsetCadenaEspecificar el conjunto de caracteres de la solicitud
statusCodeObjeto comúnObjeto que llama a la función cuando la respuesta tiene un código de HTTP correspondiente
$.ajax({
  statusCode:{
    404:function(){
      alert('No se encontró la página');
    }
  }
})
success(response,status,xhr)FunciónFunción que se ejecutará cuando la solicitud tenga éxito
timeoutNúmeroTiempo de espera local de la solicitud (en milisegundos)
traditionalBooleanoUn valor booleano que especifica si se debe usar un estilo de serialización de parámetros tradicional
typeCadenamethodcomo alias. Si está utilizando1.9En versiones de jQuery 1.0 o anteriores, debe usar type
urlCadenaEspecificar la URL a la que se enviará la solicitud. El valor predeterminado es la página actual
usernameCadenaEspecificar el nombre de usuario que se utilizará en las solicitudes de autenticación HTTP
xhrFunciónFunción para crear objetos XMLHttpRequest

Métodos Ajax de jQuery