English | 简体中文 | 繁體中文 | Русский язык | Français | Español | Português | Deutsch | 日本語 | 한국어 | Italiano | بالعربية
$ .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.
$.ajaxSetup({name:value, name:value, ...})
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.
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:
Name | Werttyp | Beschreibung |
---|---|---|
async | Boolscher Typ | Ein boolescher Wert, der angibt, ob die Anfrage asynchron behandelt werden soll. Standardmäßig ist dies true. |
beforeSend(xhr) | Funktion | Funktion, die vor dem Senden der Anfrage ausgeführt wird |
cache | Boolscher Typ | Ein boolescher Wert, der angibt, ob die Seite durch den Browser zwischengespeichert werden soll. Standardmäßig ist dies true. |
complete(xhr,status) | Funktion | Funktion, die nach Abschluss der Anfrage ausgeführt wird (nach Erfolg und Fehlerfunktion) |
contentType | Boolescher Wert oder String | Der Inhaltstyp, der beim Senden von Daten an den Server verwendet wird. Der Standardwert ist: 'application' / x-www-form-urlencoded |
context | Normales Objekt | Gibt den Wert 'this' für alle mit AJAX verbundenen Callback-Funktionen an |
data | PlainObject oder String oder Array | Gibt die Daten an, die an den Server gesendet werden sollen |
dataFilter(data,type) | Funktion | Funktion, die das ursprüngliche Antwortdaten der XMLHttpRequest verarbeitet |
dataType | Zeichenkette | Der erwartete Datentyp der Serverantwort |
error(xhr,status,error) | Funktion | Funktion, die bei einem fehlgeschlagenen Request ausgeführt wird |
global | Boolscher Typ | Ein boolescher Wert, der angibt, ob der globale AJAX-Event-Handler ausgelöst wird. Standardmäßig ist dies true. |
ifModified | Boolscher Typ | Ein boolescher Wert, der angibt, ob die Anfrage nur erfolgreich ist, wenn die Antwort seit der letzten Anfrage geändert wurde. Der Standardwert ist: false. |
jsonp | Zeichenfolge oder boolescher Wert | Überschreibt die Callback-Funktion in der jsonp-Anfrage. |
jsonpCallback | Funktion | Gibt den Namen der Callback-Funktion für die jsonp-Anfrage an. |
method | Zeichenkette | Gibt die HTTP-Methode an, die für die Anfrage verwendet wird (Abrufen oder Veröffentlichen). Standardmäßig ist dies GET. |
password | Zeichenkette | Gibt das Passwort an, das für die Authentifizierungsanfrage über HTTP verwendet wird. |
processData | Boolscher Typ | Ein boolescher Wert, der angibt, ob die mit der Anfrage gesendeten Daten in einen Query-String umgewandelt werden sollen. Standardmäßig ist dies true. |
scriptCharset | Zeichenkette | Zeichensatz für die Anfrage spezifizieren |
statusCode | Normales Objekt | Objekt, 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) | Funktion | Funktion, die beim Erfolg der Anfrage ausgeführt wird |
timeout | Zahl | Lokale Timeout für die Anfrage (in Millisekunden) |
traditional | Boolscher Typ | Boolean-Wert, der angibt, ob das traditionelle Parameterserialisierungsstil verwendet wird |
type | Zeichenkette | methodals Alias verwenden. Wenn Sie1.9Für jQuery-Versionen vor .0 sollten Sie type verwenden |
url | Zeichenkette | URL spezifizieren, an die die Anfrage gesendet wird. Standard ist die aktuelle Seite |
username | Zeichenkette | Benutzername spezifizieren, der für HTTP-Zugangsauthentifizierungsanfragen verwendet werden soll |
xhr | Funktion | Funktion zur Erstellung von XMLHttpRequest-Objekten |