Nossos voluntários ainda não traduziram este artigo para o Português (do Brasil) . Junte-se a nós e ajude a fazer o trabalho!
Draft
This page is not complete.
The XMLHttpRequest.getResponseHeader() method returns the string containing the text of the specified header. If there are multiple response headers with the same name, then their values are returned as a single concatenated string, where each value is separated from the previous one by a pair of comma and space. The getResponseHeader()
method returns the value as a UTF byte squence. The search for the header name is case-insensitive.
Syntax
var myHeader = getResponseHeader(name);
Parameters
- name
- A
ByteString
representing the name of the header you want to return the text value of.
Return value
A ByteString
representing the header's text value, or null
if either the response has not yet been received or the header doesn't exist in the response.
Example
var client = new XMLHttpRequest(); client.open("GET", "unicorns-are-teh-awesome.txt", true); client.send(); client.onreadystatechange = function() { if(this.readyState == this.HEADERS_RECEIVED) { console.log(client.getResponseHeader("Content-Type")); } }
Specifications
Specification | Status | Comment |
---|---|---|
XMLHttpRequest The definition of 'getResponseHeader()' in that specification. |
Living Standard | WHATWG living standard |
Browser compatibility
Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari (WebKit) |
---|---|---|---|---|---|
Basic support | 1 | ?[1] | 5[2] 7 |
(Yes) | 1.2 |
Feature | Android | Chrome for Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|---|
Basic support | ? | 1.0 | (Yes) | ? | ? | ? |
[1] Starting from Firefox 49, empty headers are returned as empty strings in case the preference network.http.keep_empty_response_headers_as_empty_string
is set to true
, defaulting to false
. Before Firefox 49 empty headers had been ignored. Since Firefox 50 the preference defaults to true
.
[2] This feature was implemented via ActiveXObject(). Internet Explorer implements the standard XMLHttpRequest since version 7.