Options of getting a visitor identifier.

The TypeScript TIP parameter does nothing and is left for backward compatibility. It will be removed later.

interface GetOptions<TExtended, TIP> {
    debug?: boolean;
    disableTls?: boolean;
    extendedResult?: TExtended;
    ipResolution?: TIP;
    linkedId?: string;
    products?: readonly Product[];
    tag?: unknown;
    timeout?: number;
}

Type Parameters

  • TExtended extends boolean
  • TIP = unknown

Properties

debug?: boolean

(does nothing)

Deprecated

Use the debug option of load() instead

disableTls?: boolean

Prevents agent from waiting for the TLS request to complete.

Deprecated

Use the disableTls option of load() instead

extendedResult?: TExtended

Adds details about the visitor to the result

ipResolution?: TIP

Deprecated

Does nothing

linkedId?: string

linkedId is a way of linking current identification event with a custom identifier. This can be helpful to be able to filter API visit information later.

products?: readonly Product[]

Products to enable (within those that are turned on in Dashboard). You won't be billed for the disabled products. By default, all the products are enabled.

tag?: unknown

Tag is a user-provided value or object that will be returned back to you in a webhook message. You may want to use the tag value to be able to associate a server-side webhook event with a web request of the current visitor.

What values can be used as a tag? Anything that identifies a visitor or a request. You can pass the requestId as a tag and then get this requestId back in the webhook, associated with a visitorId.

timeout?: number

Controls client-side timeout. Client timeout controls total time (both client-side and server-side) that any identification event is allowed to run. It doesn't include time when the page is in background (not visible). The value is in milliseconds.

Default

10000

Generated using TypeDoc