---
title: History API
slug: Web/API/History_API
translation_of: Web/API/History_API
---
<div>{{DefaultAPISidebar("History API")}}</div>

<p>Об'єкт DOM {{DOMxRef("Window")}} надає доступ до сеансу історії браузера через об'єкт {{DOMxRef("Window.history","history")}}. Він має корисні методи та властивості, які дозволяють відкривати попередні і наступні сторінки з історії користувача та впливати на вміст стеку історії.</p>

<h2 id="Концепція_та_використання">Концепція та використання</h2>

<p><span class="VIiyi" lang="uk"><span class="ChMk0b JLqJ4b"><span>Навігація </span></span></span> по історії користувача здійснюється за допомогою методів {{DOMxRef("History.back","back()")}}, {{DOMxRef("History.forward","forward()")}} та {{DOMxRef("History.go","go()")}}.</p>

<h3 id="Навігація_вперед_і_назад"><span class="VIiyi" lang="uk"><span class="ChMk0b JLqJ4b"><span>Навігація вперед і назад</span></span></span></h3>

<p>Щоб відкрити попередню сторінку:</p>

<pre class="brush: js notranslate">window.history.back()
</pre>

<p>Цей метод діє так само, ніби реальний користувач натиснув кнопку <kbd><strong>Назад</strong></kbd> на панелі інструментів свого браузера.</p>

<p>Подібним чином можна відкрити наступну сторінку (кнопка <kbd><strong>Вперед</strong></kbd> на панелі інструментів):</p>

<pre class="brush: js notranslate">window.history.forward()
</pre>

<h3 id="Перехід_до_певної_точки_в_історії"><span class="VIiyi" lang="uk"><span class="ChMk0b JLqJ4b"><span>Перехід до певної точки в історії</span></span></span></h3>

<p>Щоб завантажити певну сторінку з історії сеансу використовується метод {{DOMxRef("History.go","go()")}}, передаючи як аргумент відносне положення до поточної сторінки (позиція поточної сторінки дорівнює <code>0</code>.)</p>

<p>Щоб повернутися на одну сторінку назад (еквівалент виклику {{DOMxRef("History.back","back()")}}):</p>

<pre class="brush: js notranslate">window.history.go(-1)
</pre>

<p><span class="VIiyi" lang="uk"><span class="ChMk0b JLqJ4b"><span>Перехід на сторінку вперед, подібно до виклику </span></span></span>{{DOMxRef("History.forward","forward()")}}:</p>

<pre class="brush: js notranslate">window.history.go(1)
</pre>

<p>Подібним чином можна рухатись на 2 сторінки вперед, передаючи як аргумент <code>2</code> тощо.</p>

<p>Ще одне застосування методу <code>go()</code> – оновлення поточної сторінки, використовуючи для цього аргумент <code>0</code>, або викликаючи метод без аргументу:</p>

<pre class="brush: js notranslate">// Наступний код
// оновить поточну сторінку
window.history.go(0)
window.history.go()
</pre>

<p>Кількість сторінок у стеку історії визначається значенням властивості <code>length</code>:</p>

<pre class="brush: js notranslate">let numberOfEntries = window.history.length
</pre>

<h2 id="Інтерфейси">Інтерфейси</h2>

<dl>
 <dt>{{domxref("History")}}</dt>
 <dd>Дозволяє управляти історією сеансу браузера (відвіданими сторінками у вкладці або фреймі, куди завантажується поточна сторінка).</dd>
</dl>

<h2 id="Приклади">Приклади</h2>

<p>В наступному прикладі призначається обробка подій через властивість <code>onpopstate</code> щоб проілюструвати деякі методи об’єкта історії для додавання, заміни та переміщення в історії браузера в поточній вкладці.</p>

<pre class="brush:js line-numbers language-js notranslate">window.onpopstate = function(event) {
  console.log(`location: ${document.location}, state: ${JSON.stringify(event.state)}`)
}

history.pushState({page: 1}, "title 1", "?page=1")
history.pushState({page: 2}, "title 2", "?page=2")
history.replaceState({page: 3}, "title 3", "?page=3")
history.back() // виведе в консоль "location: http://example.com/example.html?page=1, state: {"page":1}"
history.back() // виведе в консоль "location: http://example.com/example.html, state: null"
history.go(2)  // виведе в консоль "location: http://example.com/example.html?page=3, state: {"page":3}"</pre>

<h2 id="Специфікація">Специфікація</h2>

<table class="standard-table">
 <thead>
  <tr>
   <th scope="col">Специфікація</th>
   <th scope="col">Статус</th>
   <th scope="col">Коментар</th>
  </tr>
 </thead>
 <tbody>
  <tr>
   <td>{{SpecName("HTML WHATWG", "browsers.html#history", "History")}}</td>
   <td>{{Spec2("HTML WHATWG")}}</td>
   <td>No change from {{SpecName("HTML5 W3C")}}.</td>
  </tr>
  <tr>
   <td>{{SpecName("HTML5 W3C", "browsers.html#history", "History")}}</td>
   <td>{{Spec2("HTML5 W3C")}}</td>
   <td>Initial definition.</td>
  </tr>
 </tbody>
</table>

<h2 id="Сумісність">Сумісність</h2>



<p>{{Compat("api.History")}}</p>

<h2 id="Дивіться_також">Дивіться також</h2>

<h3 id="Довідка">Довідка</h3>

<ul>
 <li>{{ domxref("window.history") }}</li>
 <li>{{ domxref("window.onpopstate") }}</li>
</ul>

<h3 id="Посібник">Посібник</h3>

<ul>
 <li><a href="/en-US/docs/Web/API/History_API/Working_with_the_History_API">Working with the History API</a></li>
</ul>