XMLHttpRequest: open() Methode

Baseline Widely available

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

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

Die XMLHttpRequest-Methode open() initialisiert eine neu erstellte Anfrage oder reinitialisiert eine bestehende.

Hinweis: Der Aufruf dieser Methode für eine bereits aktive Anfrage (eine, für die open() bereits aufgerufen wurde) entspricht dem Aufruf von abort().

Syntax

js
open(method, url)
open(method, url, async)
open(method, url, async, user)
open(method, url, async, user, password)

Parameter

method

Die zu verwendende HTTP-Anfragemethode wie "GET", "POST", "PUT", "DELETE", usw. Wird für nicht-http(s) URLs ignoriert.

url

Ein String oder ein anderes Objekt mit einem Stringifier — einschließlich eines URL-Objekts —, das die URL der Ressource bereitstellt, an die die Anfrage gesendet werden soll.

async Optional

Ein optionaler boolescher Parameter, der standardmäßig auf true gesetzt ist und angibt, ob die Operation asynchron durchgeführt werden soll oder nicht. Wenn dieser Wert false ist, kehrt die send()-Methode erst zurück, wenn die Antwort empfangen wurde. Bei true wird die Benachrichtigung über eine abgeschlossene Transaktion über Event-Listener bereitgestellt. Dies muss wahr sein, wenn das multipart-Attribut true ist, andernfalls wird eine Ausnahme ausgelöst.

Hinweis: Synchrone Anfragen im Hauptthread können die Benutzererfahrung leicht stören und sollten vermieden werden; tatsächlich haben viele Browser die Unterstützung synchroner XHR-Anfragen im Hauptthread vollständig eingestellt. Synchrone Anfragen sind in Workers erlaubt.

user Optional

Der optionale Benutzername für Authentifizierungszwecke; standardmäßig ist dies der Wert null.

password Optional

Das optionale Passwort für Authentifizierungszwecke; standardmäßig ist dies der Wert null.

Rückgabewert

Keiner (undefined).

Spezifikationen

Specification
XMLHttpRequest Standard
# the-open()-method

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch