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 die gesamte Seite aktualisieren zu müssen. Dies ermöglicht es einer Webseite, nur einen Teil der Seite zu aktualisieren, ohne die Tätigkeit des Nutzers zu unterbrechen.

Trotz seines Namens kann XMLHttpRequest zum Abrufen aller Datentypen verwendet werden, nicht nur XML.

Wenn Ihre Kommunikation das Empfangen von Ereignisdaten oder Nachrichtendaten von einem Server beinhalten muss, sollten Sie die Verwendung von Server-Sent Events über das EventSource-Interface in Betracht ziehen. Für eine bidirektionale Kommunikation können WebSockets die 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, das den Antwortinhalt 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 fehlgeschlagen ist oder noch nicht gesendet wurde.
XMLHttpRequest.responseType: Gibt den Typ der Antwort an.
XMLHttpRequest.responseURL Schreibgeschützt: Gibt die serialisierte URL der Antwort oder einen 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 fehlgeschlagen ist, 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 die von dem HTTP-Server zurückgesendete Antwortzeichenfolge enthält. Anders als XMLHttpRequest.status enthält dies den gesamten Text der Antwortnachricht ("OK" zum Beispiel).

Hinweis: Gemäß 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 Grund-Phrase zu übertragen, die in einer HTTP/1.1-Statuszeile enthalten sind.
XMLHttpRequest.timeout: Die Zeit in Millisekunden, die eine Anfrage 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 Access-Control-Anfragen über Credentials wie Cookies oder Autorisierungs-Header erfolgen sollen; ansonsten false.

Nicht-standardisierte Eigenschaften

XMLHttpRequest.mozAnon Schreibgeschützt Nicht standardisiert: Ein Boolean. Wenn true, wird die Anfrage ohne Cookie- und Authentifizierungs-Header 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 Antwort-Header, getrennt durch CRLF, als String zurück oder null, wenn keine Antwort eingegangen ist.
XMLHttpRequest.getResponseHeader(): Gibt den String mit dem Text des angegebenen Headers zurück oder null, wenn entweder die Antwort noch nicht eingegangen ist 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), kehrt diese Methode zurück, sobald die Anfrage gesendet wird.
XMLHttpRequest.setAttributionReporting() Sicherer Kontext Veraltet: Gibt an, dass Sie möchten, dass die Antwort der Anfrage eine Quell- oder Ereigniszuordnung registrieren kann.
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 über die onreadystatechange-Event-Handler-Eigenschaft verfügbar.

Spezifikationen

Specification
XMLHttpRequest # interface-xmlhttprequest

Browser-Kompatibilität

Siehe auch

XMLSerializer: Serialisieren 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