XMLHttpRequest : méthode open()

Syntaxe

open(method, url)
open(method, url, async)
open(method, url, async, user)
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 chaîne de caractères représentant l'URL ou tout autre objet avec un convertisseur en chaîne de caractères — y compris un objet URL — qui fournit l'URL de la ressource à laquelle envoyer la requête.

async Facultatif

Un paramètre booléen optionnel, dont la valeur par défaut est true, indiquant si l'opération doit être effectuée de manière asynchrone ou non. Si cette valeur est false, la méthode send() ne retourne pas tant que la réponse n'a pas été reçue. Si elle est true, la notification de la fin de la transaction est fournie à l'aide des écouteurs d'évènements. Cela doit être vrai si l'attribut multipart est true, sinon une exception est levée.

Note : Les requêtes synchrones sur le fil principal peuvent facilement perturber l'expérience utilisateur·ice et doivent être évitées ; en fait, de nombreux navigateurs ont complètement supprimé le support des XHR synchrones sur le fil principal. Les requêtes synchrones sont autorisées dans les Worker.

user Facultatif

Un nom d'utilisateur·ice optionnel à utiliser pour l'authentification ; par défaut, il s'agit de la valeur null.

password Facultatif

Le mot de passe optionnel à utiliser pour l'authentification ; par défaut, il s'agit de la valeur null.

Valeur de retour

Aucune (undefined).

Spécifications

Compatibilité des navigateurs

Voir aussi

• Utiliser XMLHttpRequest
• Les méthodes XMLHttpRequest associées : setRequestHeader(), send() et abort()