jQuery ajax()Methode
Beispiele
Verwenden Sie eine AJAX-Anfrage, um den Text eines <div>-Elements zu ändern:
Selbst ausprobieren »
Definition und Verwendung
Die ajax()-Methode wird verwendet, um eine AJAX-Anfrage (asynchrone HTTP-Anfrage) durchzuführen.
Alle jQuery-AJAX-Methoden verwenden die ajax()-Methode. Diese Methode wird normalerweise für Anfragen verwendet, die andere Methoden nicht abschließen können.
Syntax
Dieser Parameter gibt ein oder mehrere Name/Wert-Paare für die AJAX-Anfrage an.
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. Der 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 angeforderte Seite zwischenspeichert. Der Standardwert ist true. |
| complete(xhr,status) | Eine Funktion, die ausgeführt wird, wenn die Anfrage abgeschlossen ist (wird nach sowohl den success- als auch den error-Funktionen aufgerufen, 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 zum Verarbeiten der Rohantwortdaten des XMLHttpRequest. |
| 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. Standard 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. Standard ist false. |
| jsonp | Ein String zum Überschreiben der Callback-Funktion in einem jsonp. |
| jsonpCallback | Gibt den Namen der Callback-Funktion in einem jsonp an. |
| Passwort | Gibt das Passwort an, das bei einer HTTP-Zugriffsauthentifizierungsanfrage verwendet werden soll. |
| processData | Ein boolescher Wert, der angibt, ob die mit der Anfrage gesendeten Daten in einen Query-String umgewandelt werden. Standard 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 des XMLHttpRequest-Objekts. |
Weitere Beispiele
Eine asynchrone AJAX-Anfrage erstellen
Wie die async-Einstellung verwendet wird, um eine asynchrone Anfrage anzugeben.
Eine AJAX-Anfrage mit einem angegebenen Datentyp erstellen
So verwenden Sie die dataType-Einstellung, um den Datentyp der Anfrage anzugeben.
Eine AJAX-Anfrage mit Fehlern erstellen
So verwenden Sie die error-Einstellung, um Fehler bei AJAX-Anfragen zu behandeln.
Andere Erweiterungen
jQuery AJAX-Methoden