English | 简体中文 | 繁體中文 | Русский язык | Français | Español | Português | Deutsch | 日本語 | 한국어 | Italiano | بالعربية
El método $ .ajaxSetup() establece valores por defecto para solicitudes Ajax futuras.
A menos que sea cubierto por las llamadas individuales, todas las llamadas Ajax posteriores que utilicen cualquier método usarán los nuevos valores establecidos hasta la próxima llamada a $ .ajaxSetup().
$.ajaxSetup({name:value, name:value, ...})
Establecer URL por defecto para todas las solicitudes Ajax:
$.ajaxSetup({ url: "ajax_post.php" }); //Ahora, cada vez que se envíe una solicitud Ajax, se usará automáticamente la URL "ajax_post.php": $.ajax({ data: {fname:"Seagull", lname:"Anna"}, method: "POST", success: function(response){ $("div").html(response); } });Prueba a ver‹/›
Establecer URL y función de éxito por defecto para todas las solicitudes Ajax:
$.ajaxSetup({ url: "ajax_data.txt", success: function(response){ $("div").html(response); } }); $("button").click(function(){ $.ajax(); });Prueba a ver‹/›
Si la solicitud Ajax encuentra un error, se mostrará una notificación:
$.ajaxSetup({ url: "wrong_file.html", success: function(response){ $("div").html(response); }, error: function(xhr){ $("div").html("Se produjo un error: " + xhr.status + " " + xhr.statusText); } }); $("button").click(function(){ $.ajax(); });Prueba a ver‹/›
Nota:La configuración especificada aquí afectará a$.ajaxo clases derivadas basadas en Ajax (comodel método $.get())Todas las llamadas. Debido a que otros llamantes (por ejemplo, plugins) pueden esperar usar la configuración predeterminada normal, esto puede causar mal comportamiento. Por lo tanto,Se recomienda encarecidamente no usar el método $.ajaxSetup(). En lugar de eso, configure explícitamente las opciones en la llamada o defina un simple plugin.
El parámetro especifica la configuración de la solicitud AJAX utilizando uno o más pares de name:value.
Posibles nombres: 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 asincrónica. 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 devolución de llamada 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 que se utiliza 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 gestor 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 si la respuesta desde la última solicitud ha cambiado. El valor predeterminado es: false. |
jsonp | Cadena o booleano | Sobrescribe la función de devolución de llamada jsonp |
jsonpCallback | Función | Especifica el nombre de la función de devolución de llamada 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 se 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 el estilo de serialización de parámetros tradicional |
type | Cadena | methodel alias. Si está utilizando1.9En versiones de jQuery 1.0 o anteriores, se 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 la solicitud de autenticación HTTP |
xhr | Función | Función para crear objetos XMLHttpRequest |