React Router API Reference
    Preparing search index...

    Interface DataStrategyFunctionArgs<Context>

    interface DataStrategyFunctionArgs<Context = DefaultContext> {
        context: Context;
        fetcherKey: string | null;
        matches: DataStrategyMatch[];
        params: Params;
        pattern: string;
        request: Request;
        runClientMiddleware: (
            cb: DataStrategyFunction<Context>,
        ) => Promise<Record<string, DataStrategyResult>>;
        unstable_initiator: unstable_DataStrategyInitiator;
        unstable_navigationType: NavigationType | null;
        url: URL;
    }

    Type Parameters

    • Context = DefaultContext

    Hierarchy

    • DataFunctionArgs<Context>
      • DataStrategyFunctionArgs
    Index

    Properties

    context fetcherKey matches params pattern request runClientMiddleware unstable_initiator unstable_navigationType url

    Properties

    context: Context

    This is the context passed in to your server adapter's getLoadContext() function. It's a way to bridge the gap between the adapter's request/response API with your React Router app. It is only applicable if you are using a custom server adapter.

    fetcherKey: string | null

    The key of the fetcher targeted by this data strategy execution, otherwise null. Fetchers reloaded during a navigation or revalidation retain that unstable_initiator while providing their key here.

    matches: DataStrategyMatch[]

    Matches for this route extended with Data strategy APIs

    params: Params

    Dynamic route params for the current route.

    // app/routes.ts
    route("teams/:teamId", "./team.tsx"),

    // app/team.tsx
    export function loader({
      params,
    }: Route.LoaderArgs) {
      params.teamId;
      //        ^ string
    }
    pattern: string

    Matched un-interpolated route pattern for the current path (i.e., /blog/:slug). Mostly useful as a identifier to aggregate on for logging/tracing/etc.

    request: Request

    A Fetch Request instance which you can use to read headers (like cookies, and URLSearchParams from the request.

    runClientMiddleware: (
        cb: DataStrategyFunction<Context>,
    ) => Promise<Record<string, DataStrategyResult>>
    unstable_initiator: unstable_DataStrategyInitiator

    The operation that initiated this data strategy execution

    This field is experimental and subject to breaking changes.

    unstable_navigationType: NavigationType | null

    The history action ("PUSH", "REPLACE", or "POP") for a navigation- initiated execution, including fetchers reloaded by that navigation. null for initialization, fetcher, revalidation, and static executions.

    This field is experimental and subject to breaking changes.

    url: URL

    A URL instance representing the application location being navigated to or fetched.

    In Framework mode, this is a normalized URL with React-Router-specific implementation details removed (.data suffixes, index/_routes search params). For the raw incoming URL, use request.url.

    This normalization preserves standard URL pathname encoding and casing. For example, a request to /%61dmin.data produces a url.pathname of /%61dmin. This is not a canonical representation of the matched route. For authorization, attach server middleware to the protected route or a common ancestor instead of relying on literal pathname-prefix comparisons.

    Settings

    Member Visibility

    On This Page

    Properties