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

Método jQuery ajaxSetup()

Métodos AJAX de jQuery

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().

Sintaxis:

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

Ejemplo

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.

Valor del parámetro

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:

NombreTipo de valorDescripción
asyncBooleanoUn valor booleano que indica si la solicitud debe procesarse de manera asincrónica. 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 devolución de llamada relacionadas con AJAX
dataPlainObject o String o ArrayEspecifica los datos que se deben enviar al servidor
dataFilter(data,type)FunciónLa función que se utiliza 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 gestor de eventos AJAX global de la solicitud. El valor predeterminado es true
ifModifiedBooleanoUn valor booleano que especifica si la solicitud tiene éxito solo si la respuesta desde la última solicitud ha cambiado. El valor predeterminado es: false.
jsonpCadena o booleanoSobrescribe la función de devolución de llamada jsonp
jsonpCallbackFunciónEspecifica el nombre de la función de devolución de llamada 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 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ó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 el estilo de serialización de parámetros tradicional
typeCadenamethodel alias. Si está utilizando1.9En versiones de jQuery 1.0 o anteriores, se 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 la solicitud de autenticación HTTP
xhrFunciónFunción para crear objetos XMLHttpRequest

Métodos AJAX de jQuery