| window.runtime property | window.runtime.flash.net.URLRequestDefaults |
| Inheritance | URLRequestDefaults  Object |
| Runtime Versions: | AIR 1.0 |
URLRequestDefaults.setLoginCredentialsForHost(), which lets you define
default authentication credentials for requests. The URLRequest class defines
the information to use in an HTTP request.
Any properties set in a URLRequest object override those static properties set for the URLRequestDefaults class.
URLRequestDefault settings only apply to content in the caller's application domain,
with one exception: settings made by calling URLRequestDefaults.setLoginCredentialsForHost()
apply to all application domains in the currently running application.
Only Adobe® AIR™ content running in the application security sandbox can use the URLRequestDefaults class. Other content will result in a SecurityError being thrown when accessing the members or properties of this class.
See also
| Property | Defined By | ||
|---|---|---|---|
| authenticate : Boolean [static]
The default setting for the authenticate property of URLRequest objects. | URLRequestDefaults | ||
| cacheResponse : Boolean [static]
The default setting for the cacheResponse property of URLRequest objects. | URLRequestDefaults | ||
 | constructor : Object
A reference to the class object or constructor function for a given object instance. | Object | |
| followRedirects : Boolean [static]
The default setting for the followRedirects property of URLRequest objects. | URLRequestDefaults | ||
| manageCookies : Boolean [static]
The default setting for the manageCookies property of URLRequest objects. | URLRequestDefaults | ||
| prototype : Object [static]
A reference to the prototype object of a class or function object. | Object | |
| useCache : Boolean [static]
The default setting for the useCache property of URLRequest objects. | URLRequestDefaults | ||
| userAgent : String [static]
The default setting for the userAgent property of URLRequest objects. | URLRequestDefaults | ||
| Method | Defined By | ||
|---|---|---|---|
| hasOwnProperty(name:String):Boolean
Indicates whether an object has a specified property defined. | Object | |
| isPrototypeOf(theClass:Object):Boolean
Indicates whether an instance of the Object class is in the prototype chain of the object specified
as the parameter. | Object | |
| propertyIsEnumerable(name:String):Boolean
Indicates whether the specified property exists and is enumerable. | Object | |
setLoginCredentialsForHost(hostname:String, user:String, password:String):* [static]
Sets default user and password credentials for a selected host. | URLRequestDefaults | ||
| setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void
Sets the availability of a dynamic property for loop operations. | Object | |
| toString():String
Returns the string representation of the specified object. | Object | |
| valueOf():Object
Returns the primitive value of the specified object. | Object | |
| authenticate | property |
Hide Inherited Public Properties
Show Inherited Propertiesauthenticate:Boolean [read-write] | Runtime Versions: | AIR 1.0 |
The default setting for the authenticate property of URLRequest objects.
Setting the authenticate property in a URLRequest object overrides this default setting.
Note: This setting does not apply to URLRequest objects used in file upload or RTMP requests.
The default value is true.
SecurityError — The caller is not in the AIR application security sandbox.
|
See also
| cacheResponse | property |
cacheResponse:Boolean [read-write] | Runtime Versions: | AIR 1.0 |
The default setting for the cacheResponse property of URLRequest objects.
Setting the cacheResponse property in a URLRequest object overrides this default setting.
When set to true, the default behavior for the AIR application is to use the operating system's
HTTP cache. This setting does not apply to URLRequest objects used in file upload or RTMP requests.
The default value is true.
SecurityError — The caller is not in the AIR application security sandbox.
|
See also
| followRedirects | property |
followRedirects:Boolean [read-write] | Runtime Versions: | AIR 1.0 |
The default setting for the followRedirects property of URLRequest objects.
Setting the followRedirects property in a URLRequest object overrides this default setting.
This setting does not apply to URLRequest objects used in file upload or RTMP requests.
The default value is true.
SecurityError — The caller is not in the AIR application security sandbox.
|
See also
| manageCookies | property |
manageCookies:Boolean [read-write] | Runtime Versions: | AIR 1.0 |
The default setting for the manageCookies property of URLRequest objects.
Setting the manageCookies property in a URLRequest object overrides this default setting.
Note: This setting does not apply to URLRequest objects used in file upload or RTMP requests.
The default value is true.
SecurityError — The caller is not in the AIR application security sandbox.
|
See also
| useCache | property |
useCache:Boolean [read-write] | Runtime Versions: | AIR 1.0 |
The default setting for the useCache property of URLRequest objects.
Setting the useCache property in a URLRequest object overrides this default setting.
This setting does not apply to URLRequest objects used in file upload or RTMP requests.
The default value is true.
SecurityError — The caller is not in the AIR application security sandbox.
|
See also
| userAgent | property |
userAgent:String [read-write] | Runtime Versions: | AIR 1.0 |
The default setting for the userAgent property of URLRequest objects.
Setting the userAgent property in a URLRequest object overrides this
default setting.
This is also the default user agent string for all HTMLLoader objects (used
when you call the load() method of the HTMLLoader object). Setting
the userAgent property of the HTMLLoader object overrides the
URLRequestDefaults.userAgent setting.
This default value varies depending on the runtime operating system (such as Mac OS or Windows), the runtime language, and the runtime version, as in the following two examples:
"Mozilla/5.0 (Macintosh; U; PPC Mac OS X; en) AppleWebKit/420+ (KHTML, like Gecko) AdobeAIR/1.0""Mozilla/5.0 (Windows; U; en) AppleWebKit/420+ (KHTML, like Gecko) AdobeAIR/1.0"SecurityError — The caller is not in the AIR application security sandbox.
|
See also
| setLoginCredentialsForHost | () | method |
function setLoginCredentialsForHost(hostname:String, user:String, password:String):*| Runtime Versions: | AIR 1.0 |
Sets default user and password credentials for a selected host. These settings apply for URLRequest objects in all application domains of the application, not only those in the application domain of the object calling this method (whereas the static properties of the URLRequest class apply to the caller's application domain only). This allows content in the entire application (regardless of the content's application domain) to be logged in when another part of the application logs in.
Note for applications running on Mac OS: On Mac OS, when you call
this method, the application uses these credentials for the specified host
until the application is closed, even if you subsequently call
URLRequestDefaults.setLoginCredentialsForHost() for the same host.
However, if a server rejects the credentials specified by this method,
then a subsequent call to the URLRequestDefaults.setLoginCredentialsForHost()
method (for the same host) will be recognized.
Note: This method does not apply to URLRequest objects used in file upload or RTMP requests.
Parameters
hostname:String — The host name to which the user name and password are applied. This
can be a domain, such as "www.example.com" or a domain and a port number,
such as "www.example.com:80". Note that "example.com",
"www.example.com", and "sales.example.com" are each considered
unique hosts.
| |
user:String — The default user name to use in request authentication for the specified host.
| |
password:String — The default password to use in request authentication for the specified host.
|
* |
SecurityError — The caller is not in the AIR application security sandbox.
|