jQuery ajax()Método
Ejemplo
Usa una solicitud AJAX para cambiar el texto del elemento <div>:
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
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.
Otras extensiones
Métodos AJAX de jQuery