jQuery ajax()Método

jQuery AJAX 方法Métodos AJAX de jQuery

Ejemplo

Usa una solicitud AJAX para cambiar el texto del elemento <div>:

$("button").click(function(){ $.ajax({url:"demo_test.txt",success:function(result){ $("#div1").html(result); }}); });

Pruébalo »

Definición y uso

El método ajax() se utiliza para realizar solicitudes AJAX (HTTP asíncrono).

Todos los métodos AJAX de jQuery utilizan el método ajax(). Este método se usa generalmente para solicitudes que otros métodos no pueden completar.


Sintaxis

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

Este parámetro especifica uno o más pares nombre/valor para la solicitud AJAX.

En la siguiente tabla se enumeran los posibles nombres/valores:

Nombre Valor/Descripción
async Valor booleano que indica si la solicitud se procesa de forma asíncrona. El valor predeterminado es true.
beforeSend(xhr) Función que se ejecuta antes de enviar la solicitud.
cache Valor booleano que indica si el navegador almacena en caché la página solicitada. El valor predeterminado es true.
complete(xhr,status) Función que se ejecuta cuando se completa la solicitud (se llama tanto después del éxito como del fracaso, es decir, después de las funciones success y error).
contentType El tipo de contenido utilizado al enviar datos al servidor. El valor predeterminado es: "application/x-www-form-urlencoded".
context Especifica el valor "this" para todas las funciones de devolución de llamada relacionadas con AJAX.
data Especifica los datos que se enviarán al servidor.
dataFilter(data,type) Función utilizada para procesar los datos de respuesta sin procesar de XMLHttpRequest.
dataType El tipo de datos esperado en la respuesta del servidor.
error(xhr,status,error) Función que se ejecuta si la solicitud falla.
global Valor booleano que especifica si se activan los manejadores de eventos AJAX globales para la solicitud. El valor predeterminado es true.
ifModified Valor booleano que especifica si la solicitud solo tiene éxito cuando la respuesta ha cambiado desde la última solicitud. El valor predeterminado es false.
jsonp Una cadena para reescribir la función de devolución de llamada en un jsonp.
jsonpCallback Especifica el nombre de la función de devolución de llamada en un jsonp.
password Especifica la contraseña utilizada en la solicitud de autenticación de acceso HTTP.
processData Valor booleano que especifica si los datos enviados a través de la solicitud se convierten en una cadena de consulta. El valor predeterminado es true.
scriptCharset Especifica el juego de caracteres de la solicitud.
success(result,status,xhr) Función que se ejecuta cuando la solicitud tiene éxito.
timeout Establece el tiempo de espera local de la solicitud (en milisegundos).
traditional Valor booleano que especifica si se utiliza el estilo tradicional de serialización de parámetros.
type Especifica el tipo de solicitud (GET o POST).
url Especifica la URL a la que se envía la solicitud. El valor predeterminado es la página actual.
username Especifica el nombre de usuario utilizado en la solicitud de autenticación de acceso HTTP.
xhr Función utilizada para crear el objeto XMLHttpRequest.


实例

Más ejemplos

Generar una solicitud AJAX asíncrona
Cómo utilizar la configuración asíncrona para especificar una solicitud asíncrona.

Generar una solicitud AJAX con un tipo de datos específico
Cómo utilizar la configuración dataType para especificar el tipo de datos de la solicitud.

Generar una solicitud AJAX con errores
Cómo utilizar la configuración de error para manejar errores en solicitudes AJAX.


jQuery AJAX 方法Métodos AJAX de jQuery

Otras extensiones