Interface ConnectRouterOptions

connectToRouter options.

interface ConnectRouterOptions {
    addRoutes?: NameLike[];
    connectTimeout?: number;
    fw?: Forwarder;
    H3Transport?: typeof H3Transport;
    mtu?: number;
    preferTcp?: boolean;
    testConnection?:
        | false
        | TestConnectionPacket
        | TestConnectionPacket[]
        | (face: FwFace) => Promise<unknown>;
    testConnectionTimeout?: number;
}

Hierarchy (View Summary)

Properties

addRoutes? connectTimeout? fw? H3Transport? mtu? preferTcp? testConnection? testConnectionTimeout?

Properties

OptionaladdRoutes

addRoutes?: NameLike[]

Routes to be added on the created face.

Default Value

["/"]

OptionalconnectTimeout

connectTimeout?: number

Connect timeout (in milliseconds).

Optionalfw

fw?: Forwarder

Logical forwarder to attach faces to.

Default Value

Forwarder.getDefault()

OptionalH3Transport

H3Transport?: typeof H3Transport

Enable HTTP/3 transport.

Remarks

This is only relevant in browser environment.

This should be set to H3Transport class instance. Having this option avoids always pulling in H3Transport code, to reduce browser bundle size in applications that do not use it.

Optionalmtu

mtu?: number

Override MTU of datagram faces.

OptionalpreferTcp

preferTcp?: boolean

Use TCP instead of UDP.

Remarks

This is only relevant in Node.js environment.

OptionaltestConnection

testConnection?:
    | false
    | TestConnectionPacket
    | TestConnectionPacket[]
    | (face: FwFace) => Promise<unknown>

Test face connection.

Default Value

"/localhop/nfd/rib/list"

Remarks

  • false: skip test.
  • string or Name or Interest or array: express Interest(s) and wait for first Data reply. If string ends with "/*", it's replaced with a random component.
  • function: execute the custom tester function.

OptionaltestConnectionTimeout

testConnectionTimeout?: number

InterestLifetime of connection test Interest packets.

Default Value

2000

Remarks

Used only if testConnection is a string or Name.

Settings

Member Visibility

On This Page

Properties