| window.runtime property | window.runtime.flash.net.dns.DNSResolver |
| Inheritance | DNSResolver  EventDispatcher Object |
| Runtime Versions: | 2 |
You can look up the following types of resource records:
- ARecord: IPv4 address for a host.
- AAAARecord: IPv6 address for a host.
- MXRecord: mail exchange record for a host.
- PTRRecord: host name for an IP address.
- SRVRecord: service record for a service
The following table indicates DNS lookup support on AIR for TV devices. Unsupported requests result in the DNSResolver object dispatching an flash.events.ErrorEvent object.
Record type specified in DNSResolver.lookup()
| Support |
|---|---|
| ARecord | Full support |
| AAAARecord | Full support |
| MXRecord | Not supported |
| PTRRecord | Supported only for IPv4 addresses, not for IPv6 addresses |
| SRVRecord | Not supported |
See also
Hide Inherited Public Properties
Show Inherited Properties| Property | Defined By | ||
|---|---|---|---|
 | constructor : Object
A reference to the class object or constructor function for a given object instance. | Object | |
| isSupported : Boolean [static] [read-only]
Indicates whether DNS lookups are supported on the client system. | DNSResolver | ||
| prototype : Object [static]
A reference to the prototype object of a class or function object. | Object | |
| Method | Defined By | ||
|---|---|---|---|
Creates a DNSResolver object. | DNSResolver | ||
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registers an event listener object with an EventDispatcher object so that the listener
receives notification of an event. | EventDispatcher | |
| dispatchEvent(event:Event):Boolean
Dispatches an event into the event flow. | EventDispatcher | |
| hasEventListener(type:String):Boolean
Checks whether the EventDispatcher object has any listeners registered for a specific type
of event. | EventDispatcher | |
| 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 | |
lookup(host:String, recordType:Class):void
Looks up a DNS resource record based on a query string. | DNSResolver | ||
| propertyIsEnumerable(name:String):Boolean
Indicates whether the specified property exists and is enumerable. | Object | |
| removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Removes a listener from the EventDispatcher object. | EventDispatcher | |
| setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void
Sets the availability of a dynamic property for loop operations. | Object | |
| toLocaleString():String
Returns the string representation of this object, formatted according to locale-specific conventions. | Object | |
| toString():String
Returns the string representation of the specified object. | Object | |
| valueOf():Object
Returns the primitive value of the specified object. | Object | |
| willTrigger(type:String):Boolean
Checks whether an event listener is registered with this EventDispatcher object or any of
its ancestors for the specified event type. | EventDispatcher | |
| Event | Summary | Defined By | ||
|---|---|---|---|---|
| [broadcast event] Dispatched when the Flash Player or AIR application gains operating system focus and becomes active. | EventDispatcher | ||
| [broadcast event] Dispatched when the Flash Player or AIR application operating loses system focus and is becoming inactive. | EventDispatcher | ||
| Dispatched when an error occurred during a DNS lookup. | DNSResolver | |||
| Dispatched when a DNS look-up is complete. | DNSResolver | |||
isSupported | property |
isSupported:Boolean [read-only] | Runtime Versions: | 2 |
Indicates whether DNS lookups are supported on the client system.
DNSResolver | () | Constructor |
public function DNSResolver()| Runtime Versions: | 2 |
Creates a DNSResolver object.
lookup | () | method |
public function lookup(host:String, recordType:Class):void| Runtime Versions: | 2 |
Looks up a DNS resource record based on a query string.
The lookup() method performs a DNS lookup asynchronously.
Listen for the lookup event to get the results of the lookup. Listen for
the error event to receive errors. Results are dispatched in a DNSResolverEvent
object.
To specify the type of resource record to look up, pass the corresponding class
in the recordType parameter. (Pass the class name itself and not a string
containing the class name.)
The content of the query string passed to the method depends on the type of resource record being looked up. The following list illustrates the query string to use for each record type.
| Record type | Query string | Example |
|---|---|---|
| ARecord | host name | "example.com" |
| AAAARecord | host name | "example.com" |
| MXRecord | host name | "example.com" |
| PTRRecord | IP address | "208.77.188.166" |
| SRVRecord | _service._protocol.host. | "_sip._tcp.example.com." |
Parameters
host:String — the query string, such as a host name, IP address, or service locator.
| |
recordType:Class — The class representing the type of DNS resource record to look up.
|
Events
lookup: — dispatched when the lookup is completed successfully. | |
error: — dispatched when the lookup fails (including when no records exist). |
Throws
ArgumentError — The host parameter value is not an appropriate query string or the recordType class is not recognized.
|
See also
error | Event |
flash.events.ErrorEventproperty ErrorEvent.type =
flash.events.ErrorEvent.ERROR| Runtime Versions: | 2 |
Dispatched when an error occurred during a DNS lookup.
Defines the value of thetype property of an error event object.
This event has the following properties:
| Property | Value |
|---|---|
bubbles | false |
cancelable | false; there is no default behavior to cancel. |
currentTarget | The object that is actively processing the Event object with an event listener. |
target | The object experiencing a network operation failure. |
text | Text to be displayed as an error message. |
lookup | Event |
flash.events.DNSResolverEventproperty DNSResolverEvent.type =
flash.events.DNSResolverEvent.LOOKUP| Runtime Versions: | 2 |
Dispatched when a DNS look-up is complete.
Defines the value of thetype property of a lookup event object.
Thu Sep 29 2011, 02:34 AM -07:00