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. Dadurch kann eine Webseite nur einen Teil der Seite aktualisieren, ohne die Tätigkeit des Nutzers zu unterbrechen.

Trotz seines Namens kann XMLHttpRequest verwendet werden, um Daten jeglicher Art abzurufen, nicht nur XML.

Wenn Ihre Kommunikation das Empfangen von Ereignisdaten oder Nachrichtendaten von einem Server umfassen muss, sollten Sie in Betracht ziehen, server-sent events über die Schnittstelle EventSource zu verwenden. Für eine bidirektionale Kommunikation sind WebSockets möglicherweise die bessere Wahl.

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 Status 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 Antwort-Entity-Body 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 nicht erfolgreich 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 nicht erfolgreich 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 Antwortstring enthält, den der HTTP-Server zurückgegeben hat. Im Gegensatz zu XMLHttpRequest.status enthält dieser den gesamten Text der Antwortnachricht (zum Beispiel "OK").

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 Grundsatz zu übermitteln, die in einer HTTP/1.1-Statuszeile enthalten sind.
XMLHttpRequest.timeout: Die Zeit in Millisekunden, die eine Anfrage dauern kann, bevor sie automatisch beendet wird.
XMLHttpRequest.upload Schreibgeschützt: Ein XMLHttpRequestUpload repräsentiert den Upload-Prozess.
XMLHttpRequest.withCredentials: Gibt true zurück, wenn Access-Control-Anfragen über Websites hinweg mit Anmeldeinformationen wie Cookies oder Autorisierungsheadern vorgenommen werden sollen; andernfalls false.

Nicht-standardisierte Eigenschaften

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

Instanz-Methoden

XMLHttpRequest.abort(): Bricht die Anfrage ab, wenn sie bereits gesendet wurde.
XMLHttpRequest.getAllResponseHeaders(): Gibt alle Antwortheader zurück, getrennt durch CRLF, als String oder null, wenn keine Antwort erhalten wurde.
XMLHttpRequest.getResponseHeader(): Gibt den String zurück, der den Text des angegebenen Headers enthält, 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), wird diese Methode sofort beendet, sobald die Anfrage gesendet wurde.
XMLHttpRequest.setAttributionReporting() Sicherer Kontext Veraltet: Gibt an, dass Sie möchten, dass die Antwort der Anfrage eine Attributionsquelle oder ein Auslösereignis registrieren kann.
XMLHttpRequest.setPrivateToken() Experimentell: Fügt Informationen zu private state token einer XMLHttpRequest-Anfrage hinzu, um private state token Operationen zu initiieren.
XMLHttpRequest.setRequestHeader(): Setzt den Wert eines HTTP-Anfrage-Headers. Sie müssen setRequestHeader() nach open() aufrufen, aber vor send().

Ereignisse

Diese Schnittstelle erbt auch Ereignisse von XMLHttpRequestEventTarget.

readystatechange: Wird ausgelöst, wann immer 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
Using 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