Javascript DNS
 (Added resolve() and local())  | 
			|||
| Line 57: | Line 57: | ||
* '''local(address)'''  | * '''local(address)'''  | ||
Returns the local IP address that is used by default as route to remote ''address''. Remote address can be specified by DNS name in which case it is resolved first.  | Returns the local IP address that is used by default as route to remote ''address''. Remote address can be specified by DNS name in which case it is resolved first.  | ||
| + | |||
| + | |||
| + | * '''pack(address,separator)'''  | ||
| + | Returns a hexadecimal string representing the packed representation of the IP address. Address can be specified by DNS name in which case it is resolved first.<br/>  | ||
| + | Returns ''undefined'' on error.  | ||
| + | |||
| + | Parameters:<br/>  | ||
| + | '''address''' IP address to pack<br/>  | ||
| + | '''separator''' Optional hexadecimal octets separator<br/>  | ||
| + | |||
| + | |||
| + | * '''unpack(hexstr)'''  | ||
| + | Returns the canonical text form of the packed IP adress provided.  | ||
| + | |||
| + | Parameters:<br/>  | ||
| + | '''hexstr''' Hexadecimal representation of the packed IP address, must be 4, 8 or 16 octets long. An 8 octets address is interpreted as a /64 IPv6 prefix.<br/>  | ||
| + | Returns ''undefined'' on error.  | ||
Revision as of 17:18, 18 December 2014
DNS resolver global object.
Methods
- query(type,name,async)
 
Make a DNS query
Parameters:
type Type of DNS Record to query
name Domain Name to query
async Optional non-blocking flag
Return:
Array of records of uniform type.
- For A, AAAA, TXT records are strings
 -  For NAPTR records are objects with fields:
- flags
 - service
 - regexp
 - replacement
 - name
 - order
 - priority
 - ttl
 
 -  For SRV records are objects with fields:
- port
 - name
 - order
 - priority
 - ttl
 
 
If async is boolean true the execution context is unlocked during the DNS operation.
- queryA(name,async)
 
Shortcut for query("A",name,async)
- queryAaaa(name,async)
 
Shortcut for query("AAAA",name,async)
- queryTxt(name,async)
 
Shortcut for query("TXT",name,async)
- queryNaptr(name,async)
 
Shortcut for query("NAPTR",name,async)
- querySrv(name,async)
 
Shortcut for query("SRV",name,async)
- resolve(name)
 
Resolves the name using the system routines. This returns at most one address and takes into account the hosts file.
- local(address)
 
Returns the local IP address that is used by default as route to remote address. Remote address can be specified by DNS name in which case it is resolved first.
- pack(address,separator)
 
Returns a hexadecimal string representing the packed representation of the IP address. Address can be specified by DNS name in which case it is resolved first.
Returns undefined on error.
Parameters:
address IP address to pack
separator Optional hexadecimal octets separator
- unpack(hexstr)
 
Returns the canonical text form of the packed IP adress provided.
Parameters:
hexstr Hexadecimal representation of the packed IP address, must be 4, 8 or 16 octets long. An 8 octets address is interpreted as a /64 IPv6 prefix.
Returns undefined on error.