English | 简体中文 | 繁體中文 | Русский язык | Français | Español | Português | Deutsch | 日本語 | 한국어 | Italiano | بالعربية
$ .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()
Sintaxis::1.5+de la solicitud AJAX:
Sintaxis uno
$.ajax(url, {name:value, name:value, ...}) :1.0+Versión:
Sintaxis dos
$.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‹/›
Los parámetros especifican uno o más pares name:value para la solicitud AJAX.
Nombres posibles: los valores en la siguiente tabla:
Nombre | Tipo de valor | Descripción |
---|---|---|
async | Booleano | Un valor booleano que indica si la solicitud debe procesarse de manera asíncrona. El valor predeterminado es true |
beforeSend(xhr) | Función | La función que se ejecuta antes de enviar la solicitud |
cache | Booleano | Un valor booleano que indica si el navegador debe cachear la página de la solicitud. El valor predeterminado es true |
complete(xhr,status) | Función | La función que se ejecuta después de que la solicitud se complete (después de las funciones de éxito y error) |
contentType | Booleano o cadena | El tipo de contenido utilizado para enviar datos al servidor. El valor predeterminado es: 'application' / x-www-form-urlencoded |
context | Objeto común | Especifica el valor de 'this' para todas las funciones de retroalimentación relacionadas con AJAX |
data | PlainObject o String o Array | Especifica los datos que se deben enviar al servidor |
dataFilter(data,type) | Función | La función utilizada para procesar los datos originales de la respuesta XMLHttpRequest |
dataType | Cadena | El tipo de datos esperado en la respuesta del servidor |
error(xhr,status,error) | Función | La función que se ejecuta cuando la solicitud falla |
global | Booleano | Un valor booleano que especifica si se debe activar el manejador de eventos AJAX global de la solicitud. El valor predeterminado es true |
ifModified | Booleano | Un valor booleano que especifica si la solicitud tiene éxito solo cuando la respuesta desde la última solicitud ha cambiado. El valor predeterminado es: false. |
jsonp | Cadena o booleano | Sobrescribe la función de retroalimentación jsonp |
jsonpCallback | Función | Especifica el nombre de la función de retroalimentación para la solicitud jsonp |
method | Cadena | Especifica el método HTTP utilizado para la solicitud. (Obtener o publicar). El valor predeterminado es GET |
password | Cadena | Especifica la contraseña utilizada en la solicitud de autenticación HTTP. |
processData | Booleano | Un valor booleano que especifica si debe convertirse los datos enviados con la solicitud en una cadena de consulta. El valor predeterminado es true |
scriptCharset | Cadena | Especificar el conjunto de caracteres de la solicitud |
statusCode | Objeto común | Objeto 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ón | Función que se ejecutará cuando la solicitud tenga éxito |
timeout | Número | Tiempo de espera local de la solicitud (en milisegundos) |
traditional | Booleano | Un valor booleano que especifica si se debe usar un estilo de serialización de parámetros tradicional |
type | Cadena | methodcomo alias. Si está utilizando1.9En versiones de jQuery 1.0 o anteriores, debe usar type |
url | Cadena | Especificar la URL a la que se enviará la solicitud. El valor predeterminado es la página actual |
username | Cadena | Especificar el nombre de usuario que se utilizará en las solicitudes de autenticación HTTP |
xhr | Función | Función para crear objetos XMLHttpRequest |