| window.runtime property | window.runtime.flash.net.URLRequestHeader |
| Runtime Versions: | 1.0 |
requestHeaders property of the URLRequest class.
In Adobe® AIR, content in the application security sandbox (such as
content installed with the AIR application) can use any request headers, without error. However, for content
running in Adobe AIR that is in a different security sandbox,
using following request headers cause a runtime error to be thrown, and the
restricted terms are not case-sensitive (for example, Get, get, and GET
are each not allowed):
In Flash Player and in Adobe AIR content outside of the application security sandbox,
the following request headers cannot be used, and the restricted terms are not case-sensitive
(for example, Get, get, and GET are all not allowed). Also,
hyphenated terms apply if an underscore character is used (for example, both Content-Length and
Content_Length are not allowed):
Accept-Charset, Accept-Encoding, Accept-Ranges, Age, Allow,
Allowed, Authorization, Charge-To, Connect,
Connection,
Content-Length, Content-Location, Content-Range, Cookie,
Date, Delete,
ETag, Expect, Get, Head, Host, Keep-Alive,
Last-Modified, Location,
Max-Forwards, Options, Origin, Post,
Proxy-Authenticate, Proxy-Authorization, Proxy-Connection,
Public, Put,
Range, Referer, Request-Range, Retry-After, Server,
TE, Trace, Trailer, Transfer-Encoding,
Upgrade, URI, User-Agent, Vary, Via, Warning,
WWW-Authenticate, x-flash-version.
URLRequestHeader objects are restricted in length. If the cumulative length of a
URLRequestHeader object (the length of the name property plus the value
property) or an array of URLRequestHeader objects used in the URLRequest.requestHeaders
property exceeds the acceptable length, an exception is thrown.
Content running in Adobe AIR sets the ACCEPT header to the following, unless you
specify a setting for the ACCEPT header in the requestHeaders
property of the URLRequest class:
text/xml,
application/xml,
application/xhtml+xml,
text/html;q=0.9,
text/plain;q=0.8,
image/png,
application/x-shockwave-flash,
video/mp4;q=0.9,
flv-application/octet-stream;q=0.8,
video/x-flv;q=0.7,
audio/mp4,
*/*;q=0.5
Not all methods that accept URLRequest parameters support the requestHeaders property,
consult the documentation for the method you are calling. For example, the FileReference.upload()
and FileReference.download() methods do not
support the URLRequest.requestHeaders property.
Due to browser limitations, custom HTTP request headers are only supported for POST requests,
not for GET requests.
See also
| Property | Defined By | ||
|---|---|---|---|
| name : String
An HTTP request header name (such as Content-Type or SOAPAction). | URLRequestHeader | ||
| value : String
The value associated with the name property (such as text/plain). | URLRequestHeader | ||
| Method | Defined By | ||
|---|---|---|---|
Creates a new URLRequestHeader object that encapsulates a single HTTP request header. | URLRequestHeader | ||
| name | property |
var name:String| Runtime Versions: | 1.0 |
An HTTP request header name (such as Content-Type or SOAPAction).
| value | property |
var value:String| Runtime Versions: | 1.0 |
The value associated with the name property (such as text/plain).
| URLRequestHeader | () | Constructor |
function URLRequestHeader(name:String, value:String)| Runtime Versions: | 1.0 |
Creates a new URLRequestHeader object that encapsulates a single HTTP request header.
URLRequestHeader objects are used in the requestHeaders
property of the URLRequest class.
name:String — An HTTP request header name (such as Content-Type
or SOAPAction).
| |
value:String — The value associated with the name property
(such as text/plain).
|
