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 re-initialisiert eine bestehende.

Hinweis: Diese Methode für eine bereits aktive Anfrage aufzurufen (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", etc. 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 ausgeführt werden soll oder nicht. Wenn dieser Wert false ist, kehrt die send()-Methode nicht zurück, bis die Antwort empfangen wird. Wenn true, wird die Benachrichtigung einer abgeschlossenen Transaktion mithilfe von Event-Listenern bereitgestellt. Dies muss wahr sein, wenn das multipart-Attribut true ist, andernfalls wird eine Ausnahme ausgelöst.

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

user Optional

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

password Optional

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

Rückgabewert

Keiner (undefined).

Spezifikationen

Specification
XMLHttpRequest
# the-open()-method

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch