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
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 Wertfalse
ist, gibt diesend()
-Methode erst zurück, wenn die Antwort empfangen wurde. Wenntrue
, wird die Benachrichtigung über eine abgeschlossene Transaktion mithilfe von Ereignislistenern bereitgestellt. Dies muss true sein, wenn dasmultipart
-Attributtrue
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
Worker
s 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
- Verwendung von XMLHttpRequest
- Verwandte
XMLHttpRequest
-Methoden:setRequestHeader()
,send()
undabort()