XMLHttpRequest: response-Eigenschaft
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.
Hinweis: Diese Funktion ist in Web Workers verfügbar, mit Ausnahme von Service Workers.
Die schreibgeschützte Eigenschaft response des Interfaces XMLHttpRequest gibt den Inhalt des Antwortkörpers als ArrayBuffer, Blob, Document, JavaScript-Object oder Zeichenfolge zurück, abhängig vom Wert der Eigenschaft responseType der Anfrage.
Wert
Ein dem Wert von responseType entsprechendes Objekt.
Sie können versuchen, die Daten in einem bestimmten Format anzufordern, indem Sie den Wert von responseType festlegen, nachdem Sie open() zum Initialisieren der Anfrage aufgerufen haben, aber bevor Sie die Anfrage mit send() an den Server senden.
Der Wert ist null, wenn die Anfrage noch nicht abgeschlossen oder fehlgeschlagen ist. Eine Ausnahme gilt beim Lesen von Textdaten mit einem responseType von "text" oder der leeren Zeichenfolge (""): Solange sich die Anfrage noch im readyState LOADING (3) befindet, kann die Antwort bereits die bis dahin empfangenen Daten enthalten.
Beispiele
Dieses Beispiel zeigt eine Funktion load(), die eine Seite vom Server lädt und verarbeitet. Dazu erstellt sie ein XMLHttpRequest-Objekt und registriert einen Listener für readystatechange-Ereignisse. Wenn readyState zu DONE (4) wechselt, wird response abgerufen und an die Callback-Funktion übergeben, die load() bereitgestellt wurde.
Der Inhalt wird als Rohtext verarbeitet, da hier der Standardwert von responseType nicht überschrieben wird.
const url = "somePage.html"; // A local page
function load(url, callback) {
const xhr = new XMLHttpRequest();
xhr.onreadystatechange = () => {
if (xhr.readyState === 4) {
callback(xhr.response);
}
};
xhr.open("GET", url, true);
xhr.send("");
}
Spezifikationen
| Spezifikation |
|---|
| XMLHttpRequest # the-response-attribute |
Browser-Kompatibilität
Siehe auch
- XMLHttpRequest verwenden
- Text- und HTML/XML-Daten abrufen:
XMLHttpRequest.responseTextundXMLHttpRequest.responseXML