Усунення несправностей

Маршрути не відображаються

• Переконайтеся, що встановлено адаптер для маршрутизатора вашого застосунку.
• Перевірте, що PageFlow працює на сервері розробки, а не в продакшн-перегляді.
• Для звичайного Vite без доступного для аналізу маршрутизатора надайте явні маршрути, якщо інтеграція це підтримує.

Динамічна сторінка не відкривається

Додайте безпечні приклади значень у dynamicParams. Перевірте шаблон маршруту й відкрийте створену URL-адресу напряму, щоб виявити перенаправлення автентифікації або завантажувача.

Попередній перегляд порожній або постійно завантажується

• Перевірте консоль застосунку та мережеві запити.
• Переконайтеся, що сторінка відображається в поточному сеансі браузера.
• Дочекайтеся завантаження потрібних шрифтів і зображень.
• Для тривалої асинхронної роботи викличте window.__UNPLUGIN_PAGEFLOW_READY__?.(), коли сторінка буде готова.

Навігація відсутня

PageFlow виявляє підтримувані посилання та літеральні цілі. Обчислювані програмні цілі можуть з’явитися лише після взаємодії. Внутрішня структура Astro islands навмисно не аналізується; за потреби використовуйте якір того самого походження або data-pageflow-to.

Мініатюри застаріли

Дозвольте черзі знімків оновити видимі сторінки. Якщо кеш більше не потрібний, зупиніть сервер розробки та видаліть .unplugin-pageflow/cache.

Відображаються сторінки автентифікації

Автентифікація береться з поточного сеансу браузера. Увійдіть до локального застосунку в тому самому сеансі або сприймайте очікувану сторінку входу чи відмови в доступі як коректний перегляд.

Тести не зіставляються

Перевірте правила автоматичного зіставлення, а потім додайте явне зіставлення pageTests. Тест можна запустити, лише якщо для його типу налаштовано запис testCommands.

Не працює допоміжний процес Next.js

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