Interface nsIDNSAddrRecordType

Hierarchy

Properties

canonicalName effectiveTRRMode trrFetchDuration trrFetchDurationNetworkOnly trrSkipReason ttl

Methods

AddRef IsTRR QueryInterface Release getAddresses getNextAddr getNextAddrAsString getScriptableNextAddr hasMore reportUnusable resolvedInSocketProcess rewind

Properties

Readonly canonicalName

canonicalName: string

Returns

the canonical hostname for this record. this value is empty if the record was not fetched with the RESOLVE_CANONICAL_NAME flag.

e.g., www.mozilla.org --> rheet.mozilla.org

That the result, if IDN will be returned as punycode. e.g., élève.w3c-test.org --> xn--lve-6lad.w3c-test.org

Readonly effectiveTRRMode

effectiveTRRMode: nsIRequest_TRRMode

The TRR mode this record is used.

Readonly trrFetchDuration

trrFetchDuration: number

This attribute is only set if TRR is used and it measures time between asyncOpen on a channel and the time parsing of response if done. Thee time is measured in milliseconds.

Readonly trrFetchDurationNetworkOnly

trrFetchDurationNetworkOnly: number

This attribute is only set if TRR is used and it measures time between sending a request and the time response is received from the network. This time is similat to the time above, but exludes a time needed to make a connection and a time neededto parse results (this also does not include delays that may be introduce because parsing is perform on the main thread). Thee time is measured in milliseconds.

Readonly trrSkipReason

trrSkipReason: nsITRRSkipReason_value

If the DNS request didn't use TRR, this value contains the reason why that was skipped.

Readonly ttl

ttl: uint32_t

Returns the ttl of this record.

Methods

AddRef

  • Increases the reference count for this interface. The associated instance will not be deleted unless the reference count is returned to zero.

    Returns

    The resulting reference count.

    Returns number

IsTRR

  • Record retreived with TRR.

    Returns bool

QueryInterface

  • Parameters

    • aIID: object
    • Optional aInstancePtr: object

    Returns any

  • A run time mechanism for interface discovery.

    Returns

    NS_OK if the interface is supported by the associated instance, NS_NOINTERFACE if it is not.

    aInstancePtr must not be null.

    Parameters

    • aIID: object

      [in] A requested interface IID

    • aInstancePtr: object

      [out] A pointer to an interface pointer to receive the result.

    Returns void

Release

  • Decreases the reference count for this interface. Generally, if the reference count returns to zero, the associated instance is deleted.

    Returns

    The resulting reference count.

    Returns number

getAddresses

  • this function copies the value of all working members of the RR set into the output array.

    Parameters

    • aAddressArray: nsNetAddrTArrayRef

      The result set

    Returns void

getNextAddr

  • this function copies the value of the next IP address into the given NetAddr struct and increments the internal address iterator.

    Throws

    NS_ERROR_NOT_AVAILABLE if there is not another IP address in the record.

    Parameters

    • aPort: uint16_t

      A port number to initialize the NetAddr with.

    Returns NetAddr

getNextAddrAsString

  • this function returns the value of the next IP address as a string and increments the internal address iterator.

    Throws

    NS_ERROR_NOT_AVAILABLE if there is not another IP address in the record.

    Returns string

getScriptableNextAddr

  • this function returns the value of the next IP address as a scriptable address and increments the internal address iterator.

    Throws

    NS_ERROR_NOT_AVAILABLE if there is not another IP address in the record.

    Parameters

    • aPort: uint16_t

      A port number to initialize the nsINetAddr with.

    Returns nsINetAddr

hasMore

  • this function returns true if there is another address in the record.

    Returns boolean

reportUnusable

  • This function indicates that the last address obtained via getNextAddr*() was not usuable and should be skipped in future uses of this record if other addresses are available.

    Parameters

    • aPort: uint16_t

      is the port number associated with the failure, if any. It may be zero if not applicable.

    Returns void

resolvedInSocketProcess

  • Record is resolved in socket process.

    Returns bool

rewind

  • this function resets the internal address iterator to the first address in the record.

    Returns void

Settings

Member Visibility

Theme

Generated using TypeDoc