Неправильная позиция в 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 и закрывать меню так, будто переход состоялся.

Регрессия проверяется историей, а не одним кликом

  1. Открыть длинный список, прокрутить к известной карточке и перейти в неё.
  2. Нажать Back: карточка должна снова оказаться в viewport, а не только иметь похожий scrollY.
  3. Открыть другую карточку обычной ссылкой: новая страница начинается сверху.
  4. Перейти по двум hash, включая якорь ниже асинхронного блока; заголовок не закрыт шапкой.
  5. Сменить query пагинации и сравнить поведение с записанным продуктовым правилом.
  6. Быстро выполнить два перехода подряд и убедиться, что поздний Promise первого не прокручивает второй экран.

В e2e-тесте лучше проверять видимость контрольного элемента, а не точное равенство пикселя: шрифты и высота адаптивной шапки меняются. Для разбора сохраните версию Vue Router, конфигурацию history, реализацию scrollBehavior, последовательность URL и видеозапись с логом navigation id. Исправление готово, когда новый переход, история и якорь стабильно расходятся по своим правилам.

Проверенные источники