La méthode open()
de XMLHttpRequest
instancie une nouvelle requête ou réinitialise un déjà existante.
Note: Appeler cette méthode pour une requête déjà active (pour laquelle une méthode
open()
a déjà été appelée) est équivalent à appeler abort()
.Syntaxe
XMLHttpRequest.open(method, url) XMLHttpRequest.open(method, url, async) XMLHttpRequest.open(method, url, async, user) XMLHttpRequest.open(method, url, async, user, password)
Paramètres
method
- La méthode HTTP request à utiliser telles que :
"GET"
,"POST"
,"PUT"
,"DELETE"
, etc. Ignorée pour les URL non-HTTP(S). url
- Une
DOMString
représentant l'URL à laquelle envoyer la requête. async
Facultatif- Un booléen optionnel par défaut à
true
, indiquant s'il faut, ou pas, traiter la requête en asynchrone. Si la valeur est àfalse
, la méthodesend()
ne retourne rien tant qu'elle n'a pas reçu la réponse. Si la valeur est àtrue
, une notification de transaction complétée est fournie en utilisant un gestionnaire d'évènements. Le paramètre doit être sur "true" si l'attributmultipart
est sur "true" aussi ou une exception sera levée.Note: Les requêtes asynchrones sur le "thread" principal peuvent facilement dérouter l'utilisateur et devraient être évitées; En fait, de nombreux navigateurs ont un support XHR obsolète sur la totalité du "thread" principal. Les requêtes synchrones sont acceptées dansWorker
s. user
Facultatif- Le nom de l'utilisateur, optionnel, à utiliser dans un but d'authentification. Sa valeur par défaut est
null
. password
Facultatif- Le mot de passe, optionnel, à utiliser dans un but d'authentification. Sa valeur par défaut est
null
.
Spécificités
Specification | Status | Comment |
---|---|---|
XMLHttpRequest La définition de 'open()' dans cette spécification. |
Standard évolutif | WHATWG living standard |
Compatibilité des navigateurs
BCD tables only load in the browser
The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Voir aussi
- Utiliser XMLHttpRequest
- Méthodes
XMLHttpRequest
en relation :setRequestHeader()
,send()
, andabort()