dev
Branches
main (6.4.1)dev
Versions
6.4.1v4/5.xv3.x
shouldRevalidate

shouldRevalidate

This function allows you opt-out of revalidation for a route's loader as an optimization.

This feature only works if using a data router, see Picking a Router

There are several instances where data is revalidated, keeping your UI in sync with your data automatically:

If you define shouldRevalidate on a route, it will first check the function before calling the route loader for new data. If the function returns false, then the loader will not be called and the existing data for that loader will persist on the page.

<Route
  path="meals-plans"
  element={<MealPlans />}
  loader={loadMealPlans}
  shouldRevalidate={({ currentUrl }) => {
    // only revalidate if the submission originates from
    // the `/meal-plans/new` route.
    return currentUrl.pathname === "/meal-plans/new";
  }}
>
  <Route
    path="new"
    element={<NewMealPlanForm />}
    // `loadMealPlans` will be revalidated after
    // this action...
    action={createMealPlan}
  />
  <Route
    path=":planId/meal"
    element={<Meal />}
    // ...but not this one because origin the URL
    // is not "/meal-plans/new"
    action={updateMeal}
  />
</Route>

Note that this is only for data that has already been loaded, is currently rendered, and will continue to be rendered at the new URL. Data for new routes and fetchers at the new URL will always be fetched initially.

Using this API risks your UI getting out of sync with your data, use with caution!

Type Declaration

interface ShouldRevalidateFunction {
  (args: {
    currentUrl: URL;
    currentParams: AgnosticDataRouteMatch["params"];
    nextUrl: URL;
    nextParams: AgnosticDataRouteMatch["params"];
    formMethod?: Submission["formMethod"];
    formAction?: Submission["formAction"];
    formEncType?: Submission["formEncType"];
    formData?: Submission["formData"];
    actionResult?: DataResult;
    defaultShouldRevalidate: boolean;
  }): boolean;
}
Docs and examples CC 4.0
Edit