XMLHttpRequest.open()

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() (en-US).

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 de requête HTTP à 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éthode send() 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'attribut multipart 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 dans Worker.
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

Voir aussi

Utiliser XMLHttpRequest
Méthodes XMLHttpRequest en relation : setRequestHeader(),send(), and abort() (en-US)