re:re:actable
Урок 041 минута чтения

Что делает history объект?

На этой странице
Кратко

history управляет историей навигации вкладки: переходами назад, вперед и изменением URL без перезагрузки страницы.

Вопрос

Что делает объект history в браузере?

Определение

history - объект браузера, связанный с историей текущей вкладки. Он позволяет программно перейти назад или вперед, а также добавить или заменить запись истории.

SPA-приложения используют History API, чтобы менять URL без полной перезагрузки страницы.

Навигация

history.back();    // назад
history.forward(); // вперед
history.go(-2);    // на две записи назад

pushState()

history.pushState(
  { page: 'profile' },
  '',
  '/profile'
);

pushState() добавляет новую запись в историю и меняет URL без перезагрузки.

replaceState()

history.replaceState(
  { page: 'settings' },
  '',
  '/settings'
);

replaceState() заменяет текущую запись истории.

Событие popstate

window.addEventListener('popstate', (event) => {
  console.log(event.state);
});

popstate срабатывает при переходе по истории, например когда пользователь нажал "назад".

Что важно помнить

  • pushState и replaceState меняют URL без перезагрузки — на этом построены клиентские роутеры.
  • Событие popstate срабатывает при навигации «назад/вперед», но не при pushState.
  • Сервер должен отдавать index.html для всех маршрутов SPA, иначе прямой переход по ссылке даст 404.
  • Новый Navigation API (navigation.navigate) — более удобная замена History API.

Мини-шпаргалка

history.pushState(state, '', url);
history.replaceState(state, '', url);
history.back();

Документация

MDN: History API, MDN: Navigation API.

Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.

Поиск

Поиск по урокам