Quand elle est invoquée, cette méthode DOIT annuler toute activité du réseau dont l'objet est responsable et restaurer l'objet.

Pas de Paramètres

Pas de Valeur de Retour

Pas d'Exceptions

Si l'attribut readyState a une valeur autre que 3 (Réception) or 4 (Chargé), elle DOIT retourner null. Sinon, elle DOIT retourner tous les en-têtes HTTP, dans une seule chaîne, avec les lignes d'en-tête séparées par une paire CR (U+000D) LF (U+000A). La ligne d'état ne DOIT par être incluse.

// Le script suivant:
var r = new XMLHttpRequest();
r.open('GET', 'test.txt', false);
r.send();
print(r.getAllResponseHeaders());

// ...devrait afficher quelque chose d'équivalent au texte suivant:
Date: Dim, 24 Oct 2004 04:58:38 GMT
Server: Apache/1.3.31 (Unix)
Keep-Alive: timeout=15, max=99
Connection: Keep-Alive
Transfer-Encoding: chunked
Content-Type: text/plain; charset=utf-8

Pas de Paramètres

Valeur de Retour

Une chaîne constituée de tous les en-têtes HTTP headers. Voir le détail dans la description.

Pas d'Exceptions

Si l'attribut readyState a une valeur autre que 3 (Réception) ou 4 (Chargé), elle DOIT retourner une chaîne vide. Sinon, elle DOIT représenter la valeur de l'en-tête HTTP contenu dans les données reçues jusque-là pour la dernière requête envoyée, dans une simple chaîne. Si plus d'un en-tête de nom donné a été reçu, alors les valeurs DOIVENT être concaténées, séparées les unes des autres par une VIRGULE U+002C suivie par un ESPACE U+0020. Si aucun en-tête de ce nom n'a été reçu, alors elle DOIT retourner une chaîne vide. Les noms d'en-têtes DOIVENT être comparés sans égard à la casse avec l'argument de la méthode (en-tête).

// Le script suivant:
var r = new XMLHttpRequest();
r.open('GET', 'test.txt', false);
r.send();
print(r.getResponseHeader('Content-Type'));

// ...devrait afficher quelque chose d'équivalent au texte suivant:
Content-Type: text/plain; charset=utf-8

Paramètres

en-tête de type DOMString

Nom de l'en-tête HTTP.

Valeur de Retour

Valeur de l'en-tête HTTP donnée.

Pas d'Exceptions

L'appel de cette méthode DOIT initialiser l'object en rappelant les arguments method, uri, async (valeur par défaut true si omis), user (valeur par défaut null si omis), et password (valeur par défaut null si omis), en assignant 1 à l'attribut readyState (Ouvert), en restaurant les attributs responseText, responseXML, status, et statusText à leur valeurs initiales, et en restaurant la liste des en-têtes de requêtes.

Les restrictions de sécurité de même origine DEVRAIENT s'appliquer.

Si l'URI assigné à cette méthode contient userinfo ([RFC3986], section 3.2.1) alors le nom d'utilisateur et le mot de passe spécifiés DOIVENT être utilisés si les arguments user et password arguments sont omis Si les arguments sont donnés, ils ont la priorité, même s'ils sont null. L'utilisation de userinfo est déconseillée et PEUT ne pas fonctionner dans les implémentations.

Si open() est appelée quand readyState vaut 4 (Chargé) l'objet entier DOIT être restauré.

Paramètres

méthode de type DOMString

Un nom de méthode HTTP valide. Les valeurs GET, POST, PUT, DELETE et HEAD DOIVENT être supportées [RFC2616].

uri de type DOMString

Une URI, qui DOIT être résolue en URI absolue en utilisant l'URI de base en antémémoire.

async de type boolean, optionnel

Si l'exécution du script peut continuer ou non.

utilisateur de type DOMString, optionnel

Nom d'utilisateur.

mot de passe de type DOMString, optionnel

Mot de passe.

Pas de Valeur de Retour

Pas d'Exceptions

Si l'attribut readyState a une valeur autre que 1 (Ouvert), une exception DOIT être levée. Sinon, l'attribut readyState DOIT être assigné à 2 (Envoyé) et une requête à uri par la méthode méthode envoyée. Si le drapeau async est positionné sur faux, alors la méthode ne DOIT PAS s'achever tant que la requête n'est pas satisfaite. Sinon elle DOIT s'achever immédiatement. (Voir: open().)

Si une donnée est passée par la méthode send() elles DOIT être utilisée dans le corps de l'entité en suivant ces règles:

• Si la donnée est une DOMString, elle DOIT être encodée comme pour une transmission UTF-8.
• Si la donnée est un Document, elle DOIT être sérialisée en utilisant l'encodage donné par data.xmlEncoding, si spécifié et supporté, ou UTF-8 autrement [DOM3].
• Si la donnée n'est pas une DOMString ni un Document les mécanismes de conversion en chaîne du langage hôte DOIVENT être utilisés sur l'argument qui a été passé et le résultat DOIT être encodé comme pour une transmission UTF-8.

Invoquer send sans l'argument donnée DOIT donner le même résultat que si elle était invoquée avec un argument null. Les auteurs DEVRAIENT spécifier l'en-tête Content-Type par setRequestHeader avant d'invoquer send avec un argument.

Si la réponse est une redirection HTTP (code d'état 301, 302, 303 ou 307), alors elle DOIT être suivie de façon transparente (à moins que cela ne viole la sécurité ou les précautions contre l'entrée dans une boucle infinie). Noter que HTTP [RFC2616] impose des obligations aux AUs concernant la préservation de la méthode de requête pendant les redirections, et en outre requiert que les utilisateurs soient notifiés de certaines sortes de redirections automatiques.

Si l'AU permet la spécification d'un proxy, il DEVRAIT modifier la requête de façon appropriée; i.e., connecter au proxy au lieu du serveur originel, modifier Request-Line et envoyer les en-têtes Proxy-Authorization comme spécifié.

Si l'AU supporte l'Authentification HTTP [RFC2617] il DEVRAIT considérer les requêtes venant de cet objet comme faisant partie de l'espace de protection qui inclut les URIs accédés et envoyer des en-têtes d'Authorization et prendre en charge les requêtes non autorisées 401 de façon appropriée. Si l'authentication échoue, l'AUs devrait se placer en attente des références des utilisateurs.

Si l'AU supporte la gestion des états HTTP [RFC2109][RFC2965] il devrait persister, mettre de coté et envoyer des cookies (tels que reçus dans les en-têtes de réponse Set-Cookie et Set-Cookie2, et envoyés dans l'en-tête Cookie) selon l'applicabilité.

Si l'AU implémente une antémémoire HTTP [RFC2616] il devrait respecter les en-têtes de requête Cache-Control assignées par l'auteur (e.g., Cache-Control: no-cache outrepasse l'antémémoire). Il ne DOIT PAS envoyer les en-têtes de requête Cache-Control ou Pragma automatiquement à moins que l'utilisateur ne requiert explicitement un tel comportement (e.g., par un rechargement forcé de la page). Les réponses 304 Non Modifié qui sont le résultat des requêtes conditonnelles générées par l'UA DOIVENT être présentées comme réponse 200 OK avec le contenu approprié. De tels AUs DOIVENT permettre aux auteurs de surcharger la validation automatique d'antémémoire en assignant des en-têtes de requête (e.g., If-None-Match, If-Modified-Since), auquel cas les réponses 304 Non Modifié DOIVENT être passées aussi bien.

Si l'AU implémente une négociation du contenu dirigée par le serveur [RFC2616], il DEVRAIT assigner les en-têtes Accept-Language, Accept-Encoding et Accept-Charset de façon appropriée; il ne DOIT PAS assigner l'en-tête Accept automatiquement. Les réponses à de telles requêtes DOIVENT avoir le codage du contenu supprimé automatiquement.

Immédiatement avant la réception du corps du message (s'il y en a un), l'attribut readyState DOIT valoir 3 (Réception). Quand la requête a terminé le chargement, l'attribut readyState DOIT valoir 4 (Chargé). En cas de requête HEAD readyState DOIT valoir 4 (Chargé) immédiatement après avoir atteint 3 (Réception).

Si l'AU supporte Expect/Continue pour les corps de requête [RFC2616] il DEVRAIT insérer les en-têtes Expect et gérer les réponses 100 Continuer de façon appropriée.

Parameters

données de types variables (voir IDL)

Données à envoyer.

Pas de Valeur de Retour

Exceptions

DOMException

INVALID_STATE_ERR DOIT être levée si cette méthode est appelée quand readyState a une valeur inappropriée.

La valeur du champ d'en-tête (header) de requête nommée DOIT être assignée avec la valeur, avec les exceptions suivantes:

• Si l'attribut readyState a une valeur autre que 1 (Ouvert), une exception DOIT être levée.
• Rien ne DOIT être fait si les arguments en-tête ou valeur contiennent des caractères SAUT DE LIGNE U+000A ou RETOUR CHARRIOT U+000D, ou si l'argument en-tête contient des caractères ESPACE U+0020 SPACE ou DEUX-POINTS U+003A COLON.
• Rien ne DOIT être fait si l'argument en-tête correspond à Accept-Charset, Accept-Encoding, Content-Length, Expect, Date, Host, Keep-Alive, Referer, TE, Trailer, Transfer-Encoding ou Upgrade insensiblement à la casse.

// Le script suivant:
var client = new XMLHttpRequest();
client.open('GET', 'demo.cgi');
client.setRequestHeader('X-Test', 'one');
client.setRequestHeader('X-Test', 'two');
client.send(null);

// ...doit avoir pour résultat que l'en-tête suivant ait été envoyé:
...
X-Test: one, two
...

Les implémentations DOIVENT remplacer toute valeur existante si la valeur du champ d'en-tête de requête nommée fait partie de: Authorization, Content-Base, Content-Location, Content-MD5, Content-Range, Content-Type, Content-Version, Delta-Base, Depth, Destinaion, ETag, Expect, From, If-Modified-Since, If-Range, If-Unmodified-Since, Max-Forwards, MIME-Version, Overwrite, Proxy-Authorization, SOAPAction ou Timeout.

Sinon, si le champ d'en-tête de requête nommé a une valeur, la nouvelle valeur DOIT être combinée avec la valeur existante (section 4.2, [RFC2616]). Voir aussi la méthode send() concernant la prise en charge de l'en-tête par l'AU pour la mise en cache, l'authentification, les proxys, et les cookies.

La liste d'en-têtes de requêtes DOIT être restaurée quand la méthode open() est appelée.

Paramètres

en-tête de type DOMString

Nom de l'en-tête HTTP.

valeur de type DOMString

Valeur de l'en-tête HTTP.

Pas de Valeur de Retour

Exceptions

DOMException

INVALID_STATE_ERR DOIT être levée si readyState a une valeur inappropriée. (Voir description ci-dessus.)