Неправильная позиция в Vue Router чаще появляется не из-за самого `window.scrollTo`, а из-за смешения трёх сценариев: обычный переход должен открыть страницу сверху, Back/Forward — вернуть сохранённое место, а переход к `#anchor` — показать конкретный блок. Первый безопасный шаг: временно залогировать `to.fullPath`, `from.fullPath`, `savedPosition` и фактический `window.scrollY` после отрисовки.
`savedPosition` передаётся только при навигации `popstate`, то есть при работе кнопок Back/Forward. Если сохранять каждую координату в глобальную переменную и возвращать её для любого перехода, каталог, карточка и фильтры начинают делить одно состояние. Исправление — назначить одному `scrollBehavior` явные правила и не дублировать прокрутку в компонентах.
Четыре перехода должны дать четыре наблюдаемых результата
| Действие | Ожидаемая позиция | Что приходит в scrollBehavior |
|---|---|---|
| ссылка на новую страницу | верх страницы | savedPosition отсутствует |
| Back или Forward | место из истории | savedPosition содержит left/top |
| URL с #section | элемент-якорь | to.hash заполнен |
| смена query фильтра | решение продукта: верх или текущее место | to и from различаются query |
До правки запишите решение для каждой строки. Особенно важен query: при пагинации удобно поднимать список вверх, а при бесконечной ленте — сохранять текущий viewport. Универсального ответа нет, зато случайное поведение легко заметить, когда ожидание записано рядом с типом перехода.
Один владелец прокрутки устраняет конфликт
import { createRouter, createWebHistory } from 'vue-router'
const router = createRouter({
history: createWebHistory(),
routes,
async scrollBehavior(to, from, savedPosition) {
if (savedPosition) return savedPosition
if (to.hash) {
await viewReady()
const id = decodeURIComponent(to.hash.slice(1))
const el = document.getElementById(id)
return el ? { el, top: 0 } : { top: 0 }
}
if (to.name === from.name && to.query.page !== from.query.page) {
return { el: '#results', top: 0 }
}
return { left: 0, top: 0 }
},
})`viewReady()` в примере — обещание приложения, которое завершается после загрузки данных и обновления DOM нужного представления. Не заменяйте его постоянной задержкой на 500 мс: на быстрой машине она лишняя, на медленной всё равно закончится раньше контента. Документация Vue Router разрешает вернуть Promise, поэтому момент прокрутки можно связать с реальным событием окончания transition или готовности страницы.
Гонка видна по высоте документа
Типичный симптом: координата `savedPosition.top` верна, но в момент применения документ короче этой координаты. Браузер упирается в текущую нижнюю границу, затем данные дорисовываются, а повторной прокрутки уже нет. Снимите три значения с одним navigation id: требуемый top, `document.documentElement.scrollHeight` в scrollBehavior и высоту после исчезновения skeleton.
- Если данные можно получить до входа в маршрут, дождитесь их в navigation guard и только затем подтверждайте переход.
- Если интерфейс обязан открыться сразу, компонент сообщает о готовности layout; scrollBehavior ждёт именно этот сигнал.
- Задайте минимальную высоту skeleton, чтобы замена контента не схлопывала документ.
- Отменяйте ожидание старой навигации, когда пользователь успел открыть другой маршрут.
Якорь и фиксированная шапка требуют общего контракта
Селектор из hash может ещё отсутствовать или оказаться под sticky-header. Надёжнее получить элемент по id после готовности представления, а отступ хранить в CSS рядом с целевым блоком. `scroll-margin-top` задаёт верхний запас для прокрутки; это проще поддерживать, чем копировать высоту шапки числом во все маршруты.
:root { --header-offset: 76px; }
.article-section {
scroll-margin-top: var(--header-offset);
}
@media (max-width: 640px) {
:root { --header-offset: 60px; }
}Если id содержит символы, требующие экранирования CSS, `document.getElementById` избавляет от ошибки селектора. При отсутствии якоря выбирайте предсказуемый fallback — обычно верх страницы — и отправляйте диагностическое событие, а не оставляйте пользователя на координате предыдущего экрана.
Переиспользованный компонент не равен завершённой навигации
Маршруты `/product/1` и `/product/2` могут использовать один экземпляр компонента. Watcher на route params запускает новую загрузку, но DOM от старого товара ещё видим. Решите, блокирует ли загрузка переход или обновляется после него, и подстройте сигнал готовности. Отдельно проверяйте navigation failure: отменённый guard не должен запускать ручной scroll и закрывать меню так, будто переход состоялся.
Регрессия проверяется историей, а не одним кликом
- Открыть длинный список, прокрутить к известной карточке и перейти в неё.
- Нажать Back: карточка должна снова оказаться в viewport, а не только иметь похожий scrollY.
- Открыть другую карточку обычной ссылкой: новая страница начинается сверху.
- Перейти по двум hash, включая якорь ниже асинхронного блока; заголовок не закрыт шапкой.
- Сменить query пагинации и сравнить поведение с записанным продуктовым правилом.
- Быстро выполнить два перехода подряд и убедиться, что поздний Promise первого не прокручивает второй экран.
В e2e-тесте лучше проверять видимость контрольного элемента, а не точное равенство пикселя: шрифты и высота адаптивной шапки меняются. Для разбора сохраните версию Vue Router, конфигурацию history, реализацию scrollBehavior, последовательность URL и видеозапись с логом navigation id. Исправление готово, когда новый переход, история и якорь стабильно расходятся по своим правилам.