Inertia.js получила Live Props — реактивные данные без ручной работы с WebSocket

Тейлор представил одно из самых интересных обновлений Inertia.js 3 за последнее время — Live Props. Они позволяют автоматически обновлять данные на странице при получении событий от сервера, без перезагрузки страницы и постоянного polling. Вместе с этим в последних релизах появилось ещё несколько полезных возможностей.

1. Live Props — главное нововведение
Теперь в Laravel достаточно объявить prop как реактивный и указать событие, при котором он должен обновляться:
Inertia::render('Orders/Show', [
    'order' => Inertia::live(
        fn () => $order->fresh(),
        on: new OrderUpdated($order)
    ),
]);

Когда Laravel отправит событие OrderUpdated, Inertia автоматически обновит order через частичный HTTP-запрос. Остальная страница при этом не перезагружается. Работает через существующий Laravel Broadcasting: Echo, Reverb, Pusher. Переписывать события специально под Inertia не требуется.

2. Обновление вообще без HTTP-запросов
Появился Inertia::broadcastProps(), позволяющий отправлять новые значения непосредственно внутри WebSocket-события. Таким образом, есть два режима:
- Событие служит сигналом, после которого Inertia запрашивает актуальные данные.
- Событие сразу содержит новые данные, которые применяются без дополнительного обращения к серверу.
Второй вариант особенно полезен для счётчиков, статусов, уведомлений и других часто обновляемых элементов интерфейса.

3. Автоматическое управление подписками
Inertia самостоятельно управляет подписками на события при переходах между страницами. Предусмотрены механизмы оптимизации:
- Несколько событий объединяются в один запрос.
- Можно ограничивать частоту обновлений (throttle).
- Обновления приостанавливаются в неактивных вкладках.
- После восстановления WebSocket-соединения данные синхронизируются повторно.
Поддерживаются публичные, приватные, presence-каналы и encrypted private channels.

4. Совместимость с Deferred Props
Live Props работают совместно с Inertia::defer(), once(), optional() и always(). Например, тяжёлую статистику можно загрузить уже после отображения страницы, а затем автоматически обновлять при изменениях на сервере.

5. Новый хук useProp()
Позволяет получить значение отдельного prop и отслеживать его состояние:
const { value, loading, loaded } = useProp('order')
Теперь можно показывать индикатор обновления конкретного блока, не затрагивая состояние загрузки всей страницы.

6. Контроль автоматических обновлений
Разработчик может перехватить событие live и отменить применение данных. Например, вместо автоматического изменения содержимого таблицы можно показать сообщение «Появились новые записи» и предложить пользователю обновить данные вручную.

7. Поддержка HTTP-метода QUERY
В Inertia.js 3.10 появилась поддержка нового HTTP-метода QUERY, недавно добавленного в Laravel. Он предназначен для запросов чтения, как GET, но позволяет передавать сложные параметры в теле запроса, а не в URL. Например, фильтры с вложенными массивами, десятками параметров и сложными условиями поиска. Доступны router.query(), form.query() и method="query" в компонентах.
Inertia также запоминает параметры таких запросов для частичных обновлений, polling и бесконечной прокрутки. При обычном обновлении страницы браузером параметры не сохраняются.

8. Улучшения SSR
Для inertia:start-ssr добавлен параметр
--no-stop-before-start.
Он позволяет запускать новый SSR-процесс без предварительной остановки существующего. Особенно актуально для нескольких SSR-реплик за балансировщиком нагрузки. Также исправлен ряд ошибок, связанных с конкурентными запросами, устаревшими ответами и работой SSR.

Анонс Тейлора Отвелла
Реализация Live Props на GitHub