XMLHttpRequest.open()

La méthode open() de XMLHttpRequest instancie une nouvelle requête ou réinitialise un déjà existante.

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é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  Workers.

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

Compatibilité des navigateurs

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(), and abort()