valhalla-browser API
    Preparing search index...

    Interface RouterOptions

    Session configuration for a compatible, immutable dataset.

    interface RouterOptions {
        manifestUrl: string;
        memoryBudgetBytes?: number;
        onProgress?: (event: ProgressEvent) => void;
        retries?: number;
        timeoutMs?: number;
        transport?: TileTransport;
        wasmUrl?: string | URL;
        workerFactory?: () => Worker;
        workerUrl?: string | URL;
    }
    Index
    manifestUrl memoryBudgetBytes? onProgress? retries? timeoutMs? transport? wasmUrl? workerFactory? workerUrl?
    manifestUrl: string

    Versioned manifest URL. Relative URLs resolve against the page; the parent directory must match its release ID.

    memoryBudgetBytes?: number

    Retained decoded-tile cache budget in bytes: 1 KiB–128 MiB, default 32 MiB. This is not a total-worker memory limit.

    onProgress?: (event: ProgressEvent) => void

    Receives worker progress on the main thread. Callback exceptions are ignored; avoid blocking UI work.

    retries?: number

    Additional attempts for transient fetch failures, integer 0–5; defaults to 2.

    timeoutMs?: number

    Fetch/worker-load deadline in integer ms, 1–60,000; default 10,000. WASM startup receives at least 10 seconds.

    transport?: TileTransport

    Tile delivery backend. Defaults to indexed-tar.

    wasmUrl?: string | URL

    Optional matching WASM binary. Relative URLs resolve against the page. Defaults to the package's bundled binary.

    workerFactory?: () => Worker

    Takes precedence over workerUrl. Each call must return a fresh worker implementing this SDK version's protocol. Advanced integration only.

    workerUrl?: string | URL

    Optional matching module worker. Relative URLs resolve against the page; cross-origin URLs need CORS and blob-worker CSP permission.

    Settings
    Member Visibility

    On This Page
    Properties