Sanyanggae LogoSanyanggae

💻 Веб и фронтенд

Серверные острова Astro: отложенный рендеринг нужных частей статической страницы

Как работает server:defer, зачем нужны серверный адаптер и fallback и что проверить перед применением.

사냥개 (Sanyanggae)Опубликовано Обновлено 10 мин. чтения

Это перевод корейского оригинала. Корейский оригинал · Проверка перевода: Проверка с помощью ИИ

Поясняющая схема: Исходный HTML · Серверный остров · fallback и ответ. Серверные острова Astro: отложенный рендеринг нужных частей статической страницы
SANYANGGAE · Поясняющая схема · Исходный HTML · Серверный остров · fallback и ответ.

Описание товара одинаково для всех посетителей, но адрес доставки вошедшего пользователя может отличаться. Нужно ли из-за медленного запроса адреса задерживать и описание? На вымышленной странице продажи книг рассмотрим решение о разделении общего текста и пользовательских областей. Речь о серверных островах Astro, чья роль отличается от клиентских островов, обеспечивающих работу кнопок в браузере.

1. Разделить исходный документ и области, приходящие позже

Официальная документация серверных островов Astro объясняет откладывание серверного рендеринга компонента и получение результата отдельным запросом. Исходный HTML содержит основной текст и отображение ожидания; отдельный ответ заменяет эту область. Для обработки запросов на сервере нужен адаптер.

Оставим название книги, автора и описание в общем документе, а кандидатом на отсрочку выберем только сводку адреса. Ожидая адрес, посетитель может читать о книге. Если же для понимания кнопки оплаты нужна итоговая сумма заказа, придётся спроектировать и связь цены с действием оплаты. Одного разрезания видимых элементов на маленькие прямоугольники для функционального разделения недостаточно.

Успех зависит от того, что показано первым. Если оставить текст почти пустым и отложить большую часть, посетитель будет ждать нескольких индикаторов загрузки. Сначала составьте отдельные списки вопросов, на которые должен отвечать первый экран, и информации, которая может прийти позже. Серверные острова меняют место ожидания, но сами по себе не ускоряют запросы к базе данных.

2. Проектировать fallback как часть готового экрана

Небольшой пример показывает способ использования. Предполагается, что компонент UserDelivery и адаптер реализованы отдельно.

---
import UserDelivery from '../components/UserDelivery.astro';
---
<UserDelivery server:defer>
  <p slot="fallback">Проверяем сведения об адресе доставки.</p>
</UserDelivery>

fallback — не кратковременное украшение, а исходное содержимое, которое действительно читает посетитель. Оставьте место примерно размера итоговой карточки адреса и объясните, чего ожидают. Надпись «Доставка доступна» до получения данных может противоречить фактическому ответу. Неизвестное состояние и подтверждённый результат следует различать и визуально.

Например, посетителю, который не вошёл, может понадобиться подсказка «Войдите, чтобы увидеть сохранённый адрес доставки». Медленная сеть и отсутствие входа — разные состояния. Заранее определённые тексты и пути переходов для каждого уменьшают вероятность появления временных фраз разработчиков на рабочем экране.

3. Сохранять небольшие границы данных

При вызове компонента передавайте только значения, нужные для отображения и запроса. Если передаётся вся история заказов ради одного имени, сначала можно сократить зависимости от данных. Одни значения допустимы в публичном тексте, другие следует получать только после аутентификации пользователя. В одном списке проверьте путь передачи значений и объём их вывода на экран.

Запрос серверного острова выполняется в отдельном контексте. Если логике нужен адрес текущей страницы, рассмотрите явную передачу нужного пути из исходной страницы. Предположение, будто URL запроса внутри острова совпадает с URL исходной страницы товара, может привести к неверным рекомендациям для страницы или ссылкам возврата. При реализации безопаснее проверить реальные адреса запросов в инструментах разработчика.

Представим пример с номером книги и сведениями, идентифицирующими пользователя. Номер используется для общих рекомендаций, а пользовательские данные обрабатываются на сервере в зависимости от состояния аутентификации. Даже шифрованный формат передачи не заменяет серверную проверку прав. Отдельно задокументируйте место приёма ввода и место окончательного решения о доступе.

4. Выбирать кеширование по аудитории ответа

К общему описанию книги и личному адресу трудно применить одну политику кеширования. Руководство MDN по HTTP-кешу объясняет различие общего и частного кеша. Сначала выясните, кому разрешено показывать ответ, а не одинаковы ли данные.

Откройте страницу из двух тестовых учётных записей и убедитесь, что адрес первой не появляется у второй. Проверьте также возврат назад и обновление после выхода. Это проверка совместного результата кеш-сервера, браузера и обработки аутентификации приложением. Нельзя признать решение безопасным, прочитав лишь файл компонента.

Даже общим рекомендациям книг нужен путь обновления при изменении содержимого. Решите, допустимы ли временно устаревшие рекомендации или изменение администратором должно сразу заменять их. Вместо одного «включить кеш» запишите объект, место хранения, допустимую устарелость и условия инвалидирования: коллегам будет проще оценить проект.

5. Сначала испытать медленное соединение и сбои

Не оценивайте страницу по единственному открытию при нормальном соединении. Задержите запрос адреса, вызовите его сбой, измените состояние входа и рассмотрите каждый экран. Проверьте, можно ли читать основной текст, продолжает ли загрузочная область отталкивать следующую кнопку и доступны ли действия, зависящие от не полученных из-за сбоя данных.

Испытательная ситуацияЧто должен понять посетитель
Медленный запрос адресаЧего он ждёт и можно ли читать другое
Нет аутентификацииВидны ли предложение войти и общее описание
Сбой запросаМожно ли найти путь восстановления вместо пустого экрана
Смена учётной записиНе остались ли данные предыдущего пользователя

Если несколько островов ждут результатов друг друга, пересмотрите разделение. Запрос стоимости доставки после получения адреса, а затем вывод оплаты могут создать последовательную цепь ожидания. Возможно, лучше объединить связанные данные в одну серверную операцию или запрашивать их по действию пользователя. Большое число отдельных частей само по себе не означает хорошую архитектуру.

6. Сравнивать выигрыш до и после в одинаковых условиях

Отдельно запишите момент появления первого текста, завершения вывода адреса, доступности действий и состояния ошибок. Если исходный документ появился быстрее, но карточка адреса сильно сдвинулась или начало оплаты задержалось, опыт посетителя может измениться в другом направлении. Кроме среднего значения запишите, чего пришлось ждать в медленных случаях.

Чем конкретнее вопрос выбора острова, тем лучше. «Можно ли читать о книге, даже если эта информация задерживается?» полезнее для решения, чем «Этот сайт статический?». Проверьте среду развёртывания вместе с руководством Astro по рендерингу по запросу и начните с одной небольшой пользовательской области, проверяя также реальные сценарии сбоя.

Источники и материалы

Статья объясняет сведения из открытых источников. Упоминание организации не означает её проверки или одобрения.

Об издателе и контакты

Другие статьи по теме