XMLHttpRequest

Baseline Widely available *

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨Juli 2015⁩.

* Some parts of this feature may have varying levels of support.

Hinweis: Diese Funktion ist in Web Workers verfügbar, mit Ausnahme von Service Workers.

XMLHttpRequest (XHR)-Objekte werden verwendet, um mit Servern zu interagieren. Sie können Daten von einer URL abrufen, ohne eine vollständige Seitenaktualisierung durchführen zu müssen. Dies ermöglicht es einer Webseite, nur einen Teil der Seite zu aktualisieren, ohne das zu unterbrechen, was der Benutzer gerade tut.

Trotz seines Namens kann XMLHttpRequest verwendet werden, um Daten jeglichen Typs abzurufen, nicht nur XML.

Wenn Ihre Kommunikation das Empfangen von Ereignisdaten oder Nachrichtendaten von einem Server umfassen muss, sollten Sie die Verwendung von Server-sent events über die EventSource-Schnittstelle in Betracht ziehen. Für eine vollständige Duplex-Kommunikation könnten WebSockets eine bessere Wahl sein.

Konstruktor

XMLHttpRequest(): Der Konstruktor initialisiert ein XMLHttpRequest. Er muss aufgerufen werden, bevor andere Methoden aufgerufen werden.

Instanz-Eigenschaften

Diese Schnittstelle erbt auch Eigenschaften von XMLHttpRequestEventTarget und von EventTarget.

XMLHttpRequest.readyState Schreibgeschützt: Gibt eine Zahl zurück, die den Zustand der Anfrage darstellt.
XMLHttpRequest.response Schreibgeschützt: Gibt ein ArrayBuffer, ein Blob, ein Document, ein JavaScript-Objekt oder einen String zurück, abhängig vom Wert von XMLHttpRequest.responseType, der den Antwortkörper enthält.
XMLHttpRequest.responseText Schreibgeschützt: Gibt einen String zurück, der die Antwort auf die Anfrage als Text enthält, oder null, wenn die Anfrage erfolglos war oder noch nicht gesendet wurde.
XMLHttpRequest.responseType: Gibt den Typ der Antwort an.
XMLHttpRequest.responseURL Schreibgeschützt: Gibt die serialisierte URL der Antwort oder den leeren String zurück, wenn die URL null ist.
XMLHttpRequest.responseXML Schreibgeschützt: Gibt ein Document zurück, das die Antwort auf die Anfrage enthält, oder null, wenn die Anfrage erfolglos war, noch nicht gesendet wurde oder nicht als XML oder HTML geparst werden kann. Nicht verfügbar in Web Workers.
XMLHttpRequest.status Schreibgeschützt: Gibt den HTTP-Antwortstatuscode der Anfrage zurück.
XMLHttpRequest.statusText Schreibgeschützt: Gibt einen String zurück, der den Antworttext zurückgegeben vom HTTP-Server enthält. Im Gegensatz zu XMLHttpRequest.status enthält dies den gesamten Text der Antwortmeldung (z. B. "OK").

Hinweis: Laut der HTTP/2-Spezifikation RFC 7540, Abschnitt 8.1.2.4: Response Pseudo-Header Fields definiert HTTP/2 keine Möglichkeit, die Version oder den Grundsatz zu übertragen, die in einer HTTP/1.1-Statuszeile enthalten sind.
XMLHttpRequest.timeout: Die Zeit in Millisekunden, die eine Anfrage in Anspruch nehmen kann, bevor sie automatisch beendet wird.
XMLHttpRequest.upload Schreibgeschützt: Ein XMLHttpRequestUpload, das den Upload-Prozess darstellt.
XMLHttpRequest.withCredentials: Gibt true zurück, wenn standortübergreifende Access-Control-Anfragen unter Verwendung von Anmeldeinformationen wie Cookies oder Autorisierungsheadern gestellt werden sollen; andernfalls false.

Nicht standardisierte Eigenschaften

XMLHttpRequest.mozAnon Schreibgeschützt Nicht standardisiert: Ein boolean. Wenn true, wird die Anfrage ohne Cookie- und Authentifizierungsheader gesendet.
XMLHttpRequest.mozSystem Schreibgeschützt Nicht standardisiert: Ein boolean. Wenn true, wird die Same-Origin-Policy bei der Anfrage nicht durchgesetzt.

Instanz-Methoden

XMLHttpRequest.abort(): Bricht die Anfrage ab, wenn sie bereits gesendet wurde.
XMLHttpRequest.getAllResponseHeaders(): Gibt alle Antwortheader, getrennt durch CRLF, als String zurück oder null, wenn keine Antwort empfangen wurde.
XMLHttpRequest.getResponseHeader(): Gibt den String zurück, der den Text des angegebenen Headers enthält, oder null, wenn entweder die Antwort noch nicht empfangen wurde oder der Header in der Antwort nicht existiert.
XMLHttpRequest.open(): Initialisiert eine Anfrage.
XMLHttpRequest.overrideMimeType(): Überschreibt den MIME-Typ, der vom Server zurückgegeben wird.
XMLHttpRequest.send(): Sendet die Anfrage. Wenn die Anfrage asynchron ist (was standardmäßig der Fall ist), gibt diese Methode zurück, sobald die Anfrage gesendet wird.
XMLHttpRequest.setAttributionReporting() Sicherer Kontext Experimentell: Gibt an, dass Sie möchten, dass die Antwort der Anfrage in der Lage ist, eine Attribution-Quelle oder ein Trigger-Ereignis zu registrieren.
XMLHttpRequest.setRequestHeader(): Setzt den Wert eines HTTP-Anfrage-Headers. Sie müssen setRequestHeader() nach open(), aber vor send() aufrufen.

Ereignisse

Diese Schnittstelle erbt auch Ereignisse von XMLHttpRequestEventTarget.

readystatechange: Wird ausgelöst, wenn sich die readyState-Eigenschaft ändert. Auch verfügbar über die onreadystatechange-Ereignishandler-Eigenschaft.

Spezifikationen

Specification
XMLHttpRequest # interface-xmlhttprequest

Browser-Kompatibilität

Siehe auch

XMLSerializer: Serialisierung eines DOM-Baums in XML
Verwendung von XMLHttpRequest
Fetch API

Help improve MDN

Learn how to contribute Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden