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

Hinweis: Wenn diese Methode für eine bereits aktive Anfrage aufgerufen wird (eine, für die open() bereits aufgerufen wurde), ist dies gleichbedeutend mit 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 beliebiges anderes Objekt mit einem Stringifier — einschließlich eines URL-Objekts —, das die URL der Ressource angibt, an die die Anfrage gesendet werden soll.

async Optional

Ein optionaler Boolean-Parameter, der standardmäßig auf true gesetzt ist und angibt, ob die Operation asynchron ausgeführt werden soll. Wenn dieser Wert false ist, gibt die send()-Methode erst zurück, wenn die Antwort empfangen wurde. Wenn true, wird die Benachrichtigung über eine abgeschlossene Transaktion mithilfe von Ereignislistenern bereitgestellt. Dies muss true sein, wenn das multipart-Attribut true ist, da sonst eine Ausnahme ausgelöst wird.

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

user Optional

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

password Optional

Das optionale Passwort, das für Authentifizierungszwecke verwendet werden soll; standardmäßig ist dies der null-Wert.

Rückgabewert

Keiner (undefined).

Spezifikationen

Specification
XMLHttpRequest
# the-open()-method

Browser-Kompatibilität

Siehe auch