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

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

Specification Status Comment
XMLHttpRequest
La définition de 'open()' dans cette spécification.
Standard évolutif WHATWG living standard

Compatibilité des navigateurs

Update compatibility data on GitHub
OrdinateurMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariWebview AndroidChrome pour AndroidFirefox pour AndroidOpera pour AndroidSafari sur iOSSamsung Internet
openChrome Support complet 1Edge Support complet 12Firefox Support complet Oui
Notes
Support complet Oui
Notes
Notes Starting in Firefox 30, synchronous requests on the main thread have been deprecated due to their negative impact on performance and the user experience. Therefore, the async parameter may not be false except in a Worker.
IE Support complet 7
Support complet 7
Support complet 5
Notes
Notes Implemented via ActiveXObject
Opera Support complet OuiSafari Support complet 1.2WebView Android Support complet OuiChrome Android Support complet 18Firefox Android Support complet Oui
Notes
Support complet Oui
Notes
Notes Starting in Firefox 30, synchronous requests on the main thread have been deprecated due to their negative impact on performance and the user experience. Therefore, the async parameter may not be false except in a Worker.
Opera Android Support complet OuiSafari iOS Support complet OuiSamsung Internet Android Support complet Oui

Légende

Support complet  
Support complet
Voir les notes d'implémentation.
Voir les notes d'implémentation.

Voir aussi