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

jQuery ajax() Methode

AJAX-Methoden von jQuery

$.ajax() zur Ausführung asynchroner HTTP (Ajax)-Anfragen verwendet wird.

$.ajax() ist die Grundlage für alle von jQuery gesendeten Ajax-Anfragen. Normalerweise ist es nicht erforderlich, diesen Methoden direkt aufzurufen, da$.get(),$.post()undload()und einige andere fortgeschrittene Alternativen, die einfacher zu verwenden sind. Aber wenn weniger häufig verwendete Optionen erforderlich sind, kann $.ajax() flexibler verwendet werden.

Grammatik:

Grammatik eins:1.5+Version:

$.ajax(url, {name:value, name:value, ...})

Grammatik zwei :1.0+Version:

$.ajax(name:value, name:value, ...)

Beispiel

Verwenden Siehinzufügender AJAX-AnfragenVersionÄndern des Texts eines DIV-Elements:1.5Version:

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

Verwenden Siehinzufügender AJAX-AnfragenVersionÄndern des Texts eines DIV-Elements:1.0Version:

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

Anfordern der Seite "ajax_get.php" und Senden einiger anderer Daten:

$.ajax({
  }
  data: {fname:"Seagull", lname:"Anna"},
  success: function(response){
    $("div").html(response);
  }
});
Testen Sie es heraus‹/›

Anfordern der Seite "ajax_get.php", Senden einiger anderer Daten und Ausgabe einer Statusbenachrichtigung:

$.ajax({
  }
  data: {fname:"Seagull", lname:"Anna"},
  success: function(response, status){
        $("div").html(response);
        alert(status);
  }
});
Testen Sie es heraus‹/›

Verwenden Sie die HTTP POST-Methode, um die Seite "ajax_post.php" anzufordern:

$.ajax({
  url: "ajax_post.php",
  method: "POST",
  success: function(response){
        $("div").html(response);
  }
});
Testen Sie es heraus‹/›

Verwenden Sie die asynchrone Einstellung, um eine synchrone Anfrage zu spezifizieren:

$.ajax({
  }
  async: false,
  data: {fname:"Seagull", lname:"Anna"},
  success: function(response){
        $("div").html(response);
  }
});
Testen Sie es heraus‹/›

Verwenden Sie dataType, um die angeforderte Datentyp zu spezifizieren:

$.ajax({
  url: ""/javascript/myscript.js",
  dataType: "script"
});
Testen Sie es heraus‹/›

Wird eine Fehlermeldung bei einer Ajax-Anfrage angezeigt:

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

Eine Datei anfordern und dem Benutzer nach Abschluss der Aktion eine Benachrichtigung senden. Wird die Anfrage fehlgeschlagen, wird eine Benachrichtigung angezeigt:

let request = $.ajax({
  }
  data: {fname:"Seagull", lname:"Anna"}
});
url: "ajax_get.php",
  request.done(function(msg){
});
$("div").html(msg);
  $("div").html("Request failed: " + textStatus);
});
Testen Sie es heraus‹/›

Parameterwert

Parameter für die AJAX-Anfrage einen oder mehrere name:value-Paare angeben.

Mögliche Namen: Die Werte im folgenden Tabelle:

NameWerttypBeschreibung
asyncboolscher TypEin boolescher Wert, der angibt, ob die Anfrage asynchron behandelt werden soll. Der Standardwert ist true
beforeSend(xhr)FunktionFunktion, die vor dem Senden der Anfrage ausgeführt wird
cacheboolscher TypEin boolescher Wert, der angibt, ob die Seite des Browsers zwischen den Anfragen cached werden soll. Der Standardwert ist true
complete(xhr,status)FunktionFunktion, die nach Abschluss der Anfrage ausgeführt wird (nach dem Erfolg und dem Fehlerfunktion)
contentTypeBoolescher Wert oder StringDer Inhaltstyp, der beim Senden von Daten an den Server verwendet wird. Der Standardwert ist: application / x-www-form-urlencoded
contextGewöhnliches 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 (Abfrage oder Veröffentlichung). Standardmäßig ist dies GET.
passwordZeichenketteGibt das Passwort an, das bei der Authentifizierungsanfrage über HTTP verwendet wird.
processDataboolscher TypEin boolescher Wert, der angibt, ob die mit der Anfrage gesendeten Daten in einen Anfragesatz umgewandelt werden sollen. Standardmäßig ist dies true.
scriptCharsetZeichenketteZeichensetzung für die Anfrage angeben
statusCodeGewöhnliches ObjektObjekt, das bei Vorhandensein der entsprechenden Code bei der Antwort aufgerufen wird, um numerische HTTP-Code und Funktion abzurufen
$.ajax({
  statusCode:
    404:function()
      alert("Seite nicht gefunden");
    }
  }
)
success(response,status,xhr)FunktionFunktion, die bei Erfolg der Anfrage ausgeführt wird
timeoutZahlLokale Timeout für die Anfrage (in Millisekunden)
traditionalboolscher Typboolscher Wert, der angibt, ob das traditionelle Parameterserialisierungsschema verwendet wird
typeZeichenkettemethodals Alias verwenden. Wenn Sie1.9Für jQuery-Versionen vor .0 sollten Sie type verwenden
urlZeichenketteURL angeben, an die die Anfrage gesendet wird. Standard ist die aktuelle Seite
usernameZeichenketteBenutzername angeben, der für HTTP-Zugangsautorisierungsanfragen verwendet werden soll
xhrFunktionFunktion zur Erstellung von XMLHttpRequest-Objekten

AJAX-Methoden von jQuery