XMLHttpRequest

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.

* Einige Teile dieser Funktion werden möglicherweise unterschiedlich gut unterstützt.

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 die gesamte Seite aktualisieren zu müssen. Dies ermöglicht es einer Webseite, nur einen Teil einer Seite zu aktualisieren, ohne die Aktivität des Benutzers zu stören.

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 beinhalten muss, sollten Sie server-sent events über die EventSource-Schnittstelle in Betracht ziehen. Für eine Voll-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 repräsentiert.
XMLHttpRequest.response Schreibgeschützt: Gibt ein ArrayBuffer, ein Blob, ein Document, ein JavaScript-Objekt oder eine Zeichenkette zurück, abhängig vom Wert von XMLHttpRequest.responseType, das den Antwortinhalt enthält.
XMLHttpRequest.responseText Schreibgeschützt: Gibt eine Zeichenkette zurück, die die Antwort auf die Anfrage als Text enthält, oder null, wenn die Anfrage erfolglos war oder noch nicht gesendet wurde.
XMLHttpRequest.responseType: Bestimmt den Typ der Antwort.
XMLHttpRequest.responseURL Schreibgeschützt: Gibt die serialisierte URL der Antwort oder eine leere Zeichenkette 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 eine Zeichenkette zurück, die die vom HTTP-Server zurückgegebene Antwortzeichenkette enthält. Im Gegensatz zu XMLHttpRequest.status umfasst dies den gesamten Text der Antwortnachricht (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 in einer HTTP/1.1-Statuszeile enthaltene Version oder den Grundsatz zu übertragen.
XMLHttpRequest.timeout: Die Zeit in Millisekunden, die eine Anfrage benötigen kann, bevor sie automatisch beendet wird.
XMLHttpRequest.upload Schreibgeschützt: Ein XMLHttpRequestUpload, das den Uploadprozess darstellt.
XMLHttpRequest.withCredentials: Gibt true zurück, wenn Access-Control-Anfragen über verschiedene Seiten mit Anmeldeinformationen wie Cookies oder Autorisierungsheadern durchgeführt werden sollen, ansonsten false.

Nicht standardisierte Eigenschaften

XMLHttpRequest.mozAnon Schreibgeschützt: Ein boolescher Wert. Wenn true, wird die Anfrage ohne Cookie- und Authentifizierungsheader gesendet.
XMLHttpRequest.mozSystem Schreibgeschützt: Ein boolescher Wert. Wenn true, wird die Same-Origin-Richtlinie 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 Zeichenkette zurück, oder null, wenn keine Antwort empfangen wurde.
XMLHttpRequest.getResponseHeader(): Gibt die Zeichenkette zurück, die 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 vom Server zurückgegebenen MIME-Typ.
XMLHttpRequest.send(): Sendet die Anfrage. Wenn die Anfrage asynchron ist (was der Standard ist), gibt diese Methode sofort zurück, nachdem die Anfrage gesendet wurde.
XMLHttpRequest.setAttributionReporting() Sicherer Kontext: Gibt an, dass Sie möchten, dass die Antwort der Anfrage eine Attributionsquelle oder ein Ergeignistrigger registrieren kann.
XMLHttpRequest.setPrivateToken(): Fügt Informationen zum private state token in einem XMLHttpRequest-Aufruf hinzu, um private state token-Operationen zu initiieren.
XMLHttpRequest.setRequestHeader(): Legt den Wert eines HTTP-Anfrage-Headers fest. Sie müssen setRequestHeader() nach open(), aber vor send() aufrufen.

Ereignisse

Diese Schnittstelle erbt auch Ereignisse von XMLHttpRequestEventTarget.

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

Spezifikationen

Spezifikation
XMLHttpRequest # interface-xmlhttprequest

Browser-Kompatibilität

Siehe auch

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

Help improve MDN

Erfahren Sie, wie Sie beitragen können Diese Seite wurde automatisch aus dem Englischen übersetzt.

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