Как работает prefetch
На этой странице
Prefetch, предзагрузка, — получение данных и ресурсов возможного следующего маршрута до перехода. Это сокращает ожидание после нажатия ссылки.
Вопрос
Почему некоторые страницы открываются почти сразу и как управлять предварительными запросами?
Как это работает
В production-режиме Next.js может заранее загрузить маршрут, когда Link попадает в видимую область экрана. Результат сохраняется в клиентском кэше навигации и используется при переходе, пока подходит для повторного использования.
В App Router речь идет не просто о загрузке HTML-файла. В числе ресурсов может быть RSC Payload — данные результата серверных компонентов, которые React использует для построения следующего интерфейса, а также необходимые клиентские модули.
Объем предзагрузки зависит от маршрута и настроек. Поэтому prefetch повышает вероятность быстрого перехода, но не гарантирует отсутствие любого ожидания.
Пример: включаем и отключаем предзагрузку
При наличии соответствующих страниц:
// app/page.tsx
import Link from "next/link";
export default function HomePage() {
return (
<nav>
<Link href="/about">Об учебнике</Link>{" "}
<Link href="/large-report" prefetch={false}>
Большой отчет
</Link>
</nav>
);
}Ссылка /about использует стандартное поведение. Для /large-report автоматическая предзагрузка отключена: необходимые ресурсы запросятся при переходе. Это может быть полезно, если на экране множество дорогих и редко открываемых ссылок.
Что происходит при наведении и клике
Ссылка появилась во вьюпорте (production)
→ Next.js в простое запрашивает RSC-пейлоад маршрута (+ JS-чанки)
→ кладёт в клиентский кэш роутера
Клик
→ данные уже в кэше → React заменяет только изменившиеся сегменты
→ общие layout не перерисовываются, их состояние сохраняетсяКлассическая модель и Partial Prefetching (16.3+)
| Ссылка | Без Cache Components | С cacheComponents + partialPrefetching (по умолчанию в новых проектах 16.4) |
|---|---|---|
<Link href="/x"> | Статический маршрут — целиком; динамический — до loading.tsx | Общая App Shell маршрута (статика + закэшированное), одна на все ссылки к /x |
<Link href="/x" prefetch> | Полный маршрут, включая динамику | App Shell + закэшированный контент, зависящий от URL этой ссылки |
<Link href="/x" prefetch={false}> | Ничего | Ничего |
В новой модели сотня ссылок на /products/[slug] не порождает сотню полных предзагрузок: оболочка общая, а данные конкретного товара подтягиваются по prefetch={true} только если они закэшированы через "use cache". Подробно — в уроке Instant Navigations и Partial Prefetching.
Ручная предзагрузка
"use client";
import { useRouter } from "next/navigation";
function ProductRow({ id }: { id: string }) {
const router = useRouter();
return (
<tr onMouseEnter={() => router.prefetch(`/products/${id}`)}>
{/* … ссылка внутри строки … */}
</tr>
);
}Что важно помнить
Для обычной модели App Router без cacheComponents и дополнительных режимов частичной предзагрузки:
- Статический маршрут обычно предзагружается полностью.
- Для динамического маршрута стандартная предзагрузка может ограничиваться доступной оболочкой до границы
loading.tsx; без подходящей границы полноценная предзагрузка по умолчанию может отсутствовать. prefetch={true}явно запрашивает полную предзагрузку, аfalseотключает автоматическую.
В других режимах кэширования детали меняются. Неверно считать, что для динамической страницы всегда загружается только JavaScript.
Автоматический prefetch проверяют после next build и next start: в разработке он отключен. Предзагрузка может выполняться до клика, поэтому серверный рендеринг страницы не должен сам создавать заказ или выполнять другую мутацию.
Мини-шпаргалка
- Prefetch получает ресурсы до перехода.
Linkможет запускать его автоматически в production.prefetch={false}отключает автоматические запросы.- Результат зависит от маршрута, границ загрузки и настроек.