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

jQuery ajaxSetup() Methode

jQuery Ajax Methoden

$ .ajaxSetup() Methode stellt Standardwerte für zukünftige Ajax-Anfragen ein.

Es wird davon ausgegangen, dass alle nachfolgenden Ajax-Aufrufe, die mit jedem Methodenaufruf verwendet werden, die neuen Einstellungen verwenden, es sei denn, sie werden durch die einzelnen Aufrufe überschrieben, bis der nächste Aufruf von $ .ajaxSetup() erfolgt.

Syntax:

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

Beispiel

Stellen Sie die Standard-URL für alle AJAX-Anfragen ein:

$.ajaxSetup({
  url: "ajax_post.php"
});
//Jetzt wird bei jeder Ausgabe einer Ajax-Anfrage automatisch die URL "ajax_post.php" verwendet:
$.ajax({
  data: {fname: "Seagull", lname: "Anna"},
  method: "POST",
  success: function(response){
    $("div").html(response);
  }
});
Testen Sie es heraus‹/›

Stellen Sie Standard-URL und Erfolgsfunktion für alle AJAX-Anfragen ein:

$.ajaxSetup({
  url: "ajax_data.txt",
  success: function(response){
    $("div").html(response);
  }
});
$("button").click(function(){
  $.ajax();
});
Testen Sie es heraus‹/›

Wenn eine Ajax-Anfrage ein Fehler aufweist, wird eine Benachrichtigung angezeigt:

$.ajaxSetup({
  url: "wrong_file.html",
  success: function(response){
    $("div").html(response);
  },
  error: function(xhr){
    $("div").html("Ein Fehler ist aufgetreten: " + "" + "); + xhr.status + "" + xhr.statusText);
  }
});
$("button").click(function(){
  $.ajax();
});
Testen Sie es heraus‹/›

Hinweis:Die hier angegebenen Einstellungen beeinflussen die$.ajaxoder auf Ajax basierende Ableitungen (wieder von $.get()Alle Aufrufe. Da andere Aufrufer (z.B. Plugins) möglicherweise normale Standardwerte erwarten, kann dies zu unerwünschten Verhalten führen. DaherEs wird dringend empfohlen, die Methode $.ajaxSetup() nicht zu verwenden. Stattdessen können Sie die Optionen in der Aufruffunktion explizit festlegen oder einen einfachen Plugin definieren.

Parameterwert

Die Parameter verwenden ein oder mehrere name:value-Paare, um die Einstellungen der AJAX-Anfrage zu spezifizieren.

Mögliche Namen: Die Werte im folgenden Tabelle:

NameWerttypBeschreibung
asyncBoolscher TypEin boolescher Wert, der angibt, ob die Anfrage asynchron behandelt werden soll. Standardmäßig ist dies true.
beforeSend(xhr)FunktionFunktion, die vor dem Senden der Anfrage ausgeführt wird
cacheBoolscher TypEin boolescher Wert, der angibt, ob die Seite durch den Browser zwischengespeichert werden soll. Standardmäßig ist dies true.
complete(xhr,status)FunktionFunktion, die nach Abschluss der Anfrage ausgeführt wird (nach Erfolg und Fehlerfunktion)
contentTypeBoolescher Wert oder StringDer Inhaltstyp, der beim Senden von Daten an den Server verwendet wird. Der Standardwert ist: 'application' / x-www-form-urlencoded
contextNormales ObjektGibt den Wert 'this' für alle mit AJAX verbundenen Callback-Funktionen an
dataPlainObject oder String oder ArrayGibt die Daten an, die an den Server gesendet werden sollen
dataFilter(data,type)FunktionFunktion, die das ursprüngliche Antwortdaten der XMLHttpRequest verarbeitet
dataTypeZeichenketteDer erwartete Datentyp der Serverantwort
error(xhr,status,error)FunktionFunktion, die bei einem fehlgeschlagenen Request ausgeführt wird
globalBoolscher TypEin boolescher Wert, der angibt, ob der globale AJAX-Event-Handler ausgelöst wird. Standardmäßig ist dies true.
ifModifiedBoolscher TypEin boolescher Wert, der angibt, ob die Anfrage nur erfolgreich ist, wenn die Antwort seit der letzten Anfrage geändert wurde. Der Standardwert ist: false.
jsonpZeichenfolge oder boolescher WertÜberschreibt die Callback-Funktion in der jsonp-Anfrage.
jsonpCallbackFunktionGibt den Namen der Callback-Funktion für die jsonp-Anfrage an.
methodZeichenketteGibt die HTTP-Methode an, die für die Anfrage verwendet wird (Abrufen oder Veröffentlichen). Standardmäßig ist dies GET.
passwordZeichenketteGibt das Passwort an, das für die Authentifizierungsanfrage über HTTP verwendet wird.
processDataBoolscher TypEin boolescher Wert, der angibt, ob die mit der Anfrage gesendeten Daten in einen Query-String umgewandelt werden sollen. Standardmäßig ist dies true.
scriptCharsetZeichenketteZeichensatz für die Anfrage spezifizieren
statusCodeNormales ObjektObjekt, das bei Vorhandensein der entsprechenden HTTP-Code-Zahlen die numerischen HTTP-Codes und die Funktion aufruft
$ .ajax({
  statusCode:
    404:function()
      alert("Seite nicht gefunden");
    }
  }
)})
success(response,status,xhr)FunktionFunktion, die beim Erfolg der Anfrage ausgeführt wird
timeoutZahlLokale Timeout für die Anfrage (in Millisekunden)
traditionalBoolscher TypBoolean-Wert, der angibt, ob das traditionelle Parameterserialisierungsstil verwendet wird
typeZeichenkettemethodals Alias verwenden. Wenn Sie1.9Für jQuery-Versionen vor .0 sollten Sie type verwenden
urlZeichenketteURL spezifizieren, an die die Anfrage gesendet wird. Standard ist die aktuelle Seite
usernameZeichenketteBenutzername spezifizieren, der für HTTP-Zugangsauthentifizierungsanfragen verwendet werden soll
xhrFunktionFunktion zur Erstellung von XMLHttpRequest-Objekten

jQuery Ajax Methoden