1 files changed, 122 insertions, 0 deletions
diff --git a/files/uk/web/api/history_api/index.html b/files/uk/web/api/history_api/index.html
new file mode 100644
index 0000000000..47dc8cad03
--- /dev/null
+++ b/files/uk/web/api/history_api/index.html
@@ -0,0 +1,122 @@
+---
+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>