Interface ConnectNetworkOptions

interface ConnectNetworkOptions {
    H3Transport?: typeof H3Transport;
    addRoutes?: NameLike[];
    connectTimeout?: number;
    fallback?: readonly string[];
    fastest?: number;
    fch?: false | FchRequest;
    fw?: Forwarder;
    mtu?: number;
    preferH3?: boolean;
    preferTcp?: boolean;
    testConnection?: false | TestConnectionPacket | TestConnectionPacket[] | ((face) => Promise<unknown>);
    testConnectionTimeout?: number;
    tryDefaultGateway?: boolean;



H3Transport?: typeof H3Transport

Enable HTTP/3 transport.

This is only relevant in browser environment.

This should be set to H3Transport class instance. It reduces browser bundle size in applications that do not use H3Transport.

addRoutes?: NameLike[]

Routes to be added on the created face. Default is ["/"].

connectTimeout?: number

Connect timeout (in milliseconds).

fallback?: readonly string[]

Fallback routers, used if FCH and default gateway are both unavailable.

fastest?: number

Number of faces to keep; others are closed. Faces are ranked by shortest testConnection duration. Default is 1.

fch?: false | FchRequest

FCH request.

Default is requesting 4 routers. Pass false to disable FCH.

mtu?: number

Override MTU of datagram faces.

preferH3?: boolean

Whether to try HTTP/3 before all other options. Default is false. Ignored if H3Transport is not enabled or supported.

preferTcp?: boolean

Use TCP instead of UDP.

This is only relevant in Node.js environment.

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

Test face connection.

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

Default is "/localhop/nfd/rib/list".

Type declaration

    • (face): Promise<unknown>
    • Parameters

      Returns Promise<unknown>

testConnectionTimeout?: number

InterestLifetime of connection test Interest packets. Used only if testConnection is a string or Name. Default is 2000.

tryDefaultGateway?: boolean

Consider default IPv4 gateway as a candidate.

Generated using TypeDoc