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 kannXMLHttpRequest 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 vonServer-sent events über dieEventSource-Schnittstelle in Betracht ziehen. Für eine vollständige Duplex-Kommunikation könntenWebSockets eine bessere Wahl sein.

Konstruktor

XMLHttpRequest()

Der Konstruktor initialisiert einXMLHttpRequest. Er muss aufgerufen werden, bevor andere Methoden aufgerufen werden.

Instanz-Eigenschaften

Diese Schnittstelle erbt auch Eigenschaften vonXMLHttpRequestEventTarget und vonEventTarget.

XMLHttpRequest.readyStateSchreibgeschützt

Gibt eine Zahl zurück, die den Zustand der Anfrage darstellt.

XMLHttpRequest.responseSchreibgeschützt

Gibt einArrayBuffer, einBlob, einDocument, ein JavaScript-Objekt oder einen String zurück, abhängig vom Wert vonXMLHttpRequest.responseType, der den Antwortkörper enthält.

XMLHttpRequest.responseTextSchreibgeschützt

Gibt einen String zurück, der die Antwort auf die Anfrage als Text enthält, odernull, wenn die Anfrage erfolglos war oder noch nicht gesendet wurde.

XMLHttpRequest.responseType

Gibt den Typ der Antwort an.

XMLHttpRequest.responseURLSchreibgeschützt

Gibt die serialisierte URL der Antwort oder den leeren String zurück, wenn die URL null ist.

XMLHttpRequest.responseXMLSchreibgeschützt

Gibt einDocument zurück, das die Antwort auf die Anfrage enthält, odernull, wenn die Anfrage erfolglos war, noch nicht gesendet wurde oder nicht als XML oder HTML geparst werden kann. Nicht verfügbar inWeb Workers.

XMLHttpRequest.statusSchreibgeschützt

Gibt denHTTP-Antwortstatuscode der Anfrage zurück.

XMLHttpRequest.statusTextSchreibgeschützt

Gibt einen String zurück, der den Antworttext zurückgegeben vom HTTP-Server enthält. Im Gegensatz zuXMLHttpRequest.status enthält dies den gesamten Text der Antwortmeldung (z. B."OK").

Hinweis:Laut der HTTP/2-SpezifikationRFC 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.uploadSchreibgeschützt

EinXMLHttpRequestUpload, das den Upload-Prozess darstellt.

XMLHttpRequest.withCredentials

Gibttrue zurück, wenn standortübergreifendeAccess-Control-Anfragen unter Verwendung von Anmeldeinformationen wie Cookies oder Autorisierungsheadern gestellt werden sollen; andernfallsfalse.

Nicht standardisierte Eigenschaften

XMLHttpRequest.mozAnonSchreibgeschütztNicht standardisiert

Ein boolean. Wenn true, wird die Anfrage ohne Cookie- und Authentifizierungsheader gesendet.

XMLHttpRequest.mozSystemSchreibgeschütztNicht 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 durchCRLF, als String zurück odernull, wenn keine Antwort empfangen wurde.

XMLHttpRequest.getResponseHeader()

Gibt den String zurück, der den Text des angegebenen Headers enthält, odernull, 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 KontextExperimentell

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üssensetRequestHeader() nachopen(), aber vorsend() aufrufen.

Ereignisse

Diese Schnittstelle erbt auch Ereignisse vonXMLHttpRequestEventTarget.

readystatechange

Wird ausgelöst, wenn sich diereadyState-Eigenschaft ändert.Auch verfügbar über dieonreadystatechange-Ereignishandler-Eigenschaft.

Spezifikationen

Browser-Kompatibilität

Siehe auch

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