jQuery ajaxSetup()Methode
Beispiele
Legen Sie die Standard-URL und die Erfolgsfunktion für alle AJAX-Anfragen fest:
$("button").click(function(){
$.ajaxSetup({
url:"demo_ajax_load.txt",
success:function(result){
$("div").html(result);
}
});
$.ajax();
});
Selbst ausprobieren »
Definition und Verwendung
Die ajaxSetup()-Methode legt Standardwerte für zukünftige AJAX-Anfragen fest.
Syntax
$.ajaxSetup({name:value, name:value, ... })
Dieser Parameter legt Einstellungen für AJAX-Anfragen mit einem oder mehreren Name/Wert-Paaren fest.
Die folgende Tabelle listet die möglichen Name/Wert-Paare auf:
| Name | Wert/Beschreibung |
|---|---|
| async | Ein boolescher Wert, der angibt, ob die Anfrage asynchron verarbeitet wird. Standardwert ist true. |
| beforeSend(xhr) | Eine Funktion, die vor dem Senden der Anfrage ausgeführt wird. |
| cache | Ein boolescher Wert, der angibt, ob der Browser die angeforderten Seiten zwischenspeichert. Standardwert ist true. |
| complete(xhr,status) | Eine Funktion, die ausgeführt wird, wenn die Anfrage abgeschlossen ist (wird aufgerufen, nachdem die Anfrage erfolgreich war oder fehlgeschlagen ist, d. h. nach den success- und error-Funktionen). |
| contentType | Der Inhaltstyp, der beim Senden von Daten an den Server verwendet wird. Standard ist: "application/x-www-form-urlencoded". |
| context | Gibt den "this"-Wert für alle AJAX-bezogenen Callback-Funktionen an. |
| data | Gibt die Daten an, die an den Server gesendet werden sollen. |
| dataFilter(data,type) | Eine Funktion, die verwendet wird, um die Rohantwortdaten eines XMLHttpRequest zu verarbeiten. |
| dataType | Der erwartete Datentyp der Serverantwort. |
| error(xhr,status,error) | Eine Funktion, die ausgeführt wird, wenn die Anfrage fehlschlägt. |
| global | Ein boolescher Wert, der angibt, ob globale AJAX-Ereignishandler für die Anfrage ausgelöst werden. Standardwert ist true. |
| ifModified | Ein boolescher Wert, der angibt, ob die Anfrage nur dann erfolgreich ist, wenn sich die Antwort seit der letzten Anfrage geändert hat. Standardwert ist false. |
| jsonp | Eine Zeichenfolge, um die Rückruffunktion in einem jsonp zu überschreiben. |
| jsonpCallback | Gibt den Namen der Callback-Funktion in einem jsonp an. |
| Passwort | Gibt das Passwort an, das in einer HTTP-Zugriffsauthentifizierungsanfrage verwendet werden soll. |
| processData | Ein boolescher Wert, der angibt, ob die mit der Anfrage gesendeten Daten in eine Abfragezeichenfolge umgewandelt werden. Standardwert ist true. |
| scriptCharset | Gibt den Zeichensatz für die Anfrage an. |
| success(result,status,xhr) | Eine Funktion, die ausgeführt wird, wenn die Anfrage erfolgreich ist. |
| timeout | Legt das lokale Anforderungszeitlimit (in Millisekunden) fest. |
| traditionell | Ein boolescher Wert, der angibt, ob der traditionelle Stil der Parameterserialisierung verwendet werden soll. |
| type | Gibt den Typ der Anfrage an (GET oder POST). |
| url | Gibt die URL an, an die die Anfrage gesendet wird. Standard ist die aktuelle Seite. |
| username | Gibt den Benutzernamen an, der in einer HTTP-Zugriffsauthentifizierungsanfrage verwendet werden soll. |
| xhr | Eine Funktion zum Erstellen eines XMLHttpRequest-Objekts. |
Weitere Beispiele
Geben Sie den Fehlerhandler für AJAX-Anfragen an
Wie Sie die Einstellung error verwenden, um den Fehlerhandler für AJAX-Anfragen anzugeben.
Andere Erweiterungen
jQuery AJAX-Methoden