diff options
author | Peter Bengtsson <mail@peterbe.com> | 2020-12-08 14:43:23 -0500 |
---|---|---|
committer | Peter Bengtsson <mail@peterbe.com> | 2020-12-08 14:43:23 -0500 |
commit | 218934fa2ed1c702a6d3923d2aa2cc6b43c48684 (patch) | |
tree | a9ef8ac1e1b8fe4207b6d64d3841bfb8990b6fd0 /files/uk/web/api/headers/index.html | |
parent | 074785cea106179cb3305637055ab0a009ca74f2 (diff) | |
download | translated-content-218934fa2ed1c702a6d3923d2aa2cc6b43c48684.tar.gz translated-content-218934fa2ed1c702a6d3923d2aa2cc6b43c48684.tar.bz2 translated-content-218934fa2ed1c702a6d3923d2aa2cc6b43c48684.zip |
initial commit
Diffstat (limited to 'files/uk/web/api/headers/index.html')
-rw-r--r-- | files/uk/web/api/headers/index.html | 133 |
1 files changed, 133 insertions, 0 deletions
diff --git a/files/uk/web/api/headers/index.html b/files/uk/web/api/headers/index.html new file mode 100644 index 0000000000..529712ef22 --- /dev/null +++ b/files/uk/web/api/headers/index.html @@ -0,0 +1,133 @@ +--- +title: Заголовки +slug: Web/API/Headers +tags: + - API + - Fetch + - Fetch API + - Headers + - Інтерфейс + - Заголовки +translation_of: Web/API/Headers +--- +<div>{{ APIRef("Fetch") }}</div> + +<p>Інтерфейс <strong><code>Headers</code></strong> <a href="/en-US/docs/Web/API/Fetch_API">Fetch API</a> дозволяє вам виконувати різні дії з HTTP запитами і заголовками відповідей. Ці дії включають отримання налаштування, додавання і видалення . Об'єкт <code>Headers</code> має асоціативний список заголовків, який по замовчуванню пустий і містить ноль чи більше пар імен і значень. Ви можете додавати то цього списку, використовуючи метод типу<span style="line-height: 19.0909080505371px;"> {{domxref("Headers.append","append()")}}. У всіх методах цього інтерфейсу імена заголовків знаходяться по не чутливим до реєсту запитам </span>. </p> + +<p>З метою безпеки деякі заголовки можуть контролюватись тільки за допомогою user agent. Ці заголовки включають: {{Glossary("Forbidden_header_name", "forbidden header names", 1)}} і {{Glossary("Forbidden_response_header_name", "forbidden response header names", 1)}}.</p> + +<p>Об'єкт заголовку також має associated guard, що приймає значення: <code>immutable</code>, <code>request</code>, <code>request-no-cors</code>, <code>response</code> чи <code>none</code>. Це впливає на те чи меоди: {{domxref("Headers.set","set()")}}, {{domxref("Headers.delete","delete()")}}, і {{domxref("Headers.append","append()")}} змінюватимуть заголовок. Для більшої інформації дивіться {{Glossary("Guard")}}.</p> + +<p>Ви можете отримати об'єкт <code>Headers</code> через властивості {{domxref("Request.headers")}} і{{domxref("Response.headers")}}, і створити новий об'єкт <code>Headers</code>, використовуючи конструктор {{domxref("Headers.Headers()")}}.</p> + +<p>Об'єкт, що імплементує <code>Headers</code> може напряму використовуватись в структурі {{jsxref("Statements/for...of", "for...of")}} замість{{domxref('Headers.entries()', 'entries()')}}: <code>for (var p of myHeaders)</code>тотожний <code>for (var p of myHeaders.entries())</code>.</p> + +<div class="note"> +<p><strong>Нотатка</strong>: Ви можете знайти більше про доступні заголовки прочитавши довідку по <a href="/en-US/docs/Web/HTTP/Headers">HTTP headers</a>.</p> +</div> + +<h2 id="Конструктор">Конструктор</h2> + +<dl> + <dt>{{domxref("Headers.Headers()")}}</dt> + <dd>Створює новий об'єкт заголовку <code>Headers</code>.</dd> +</dl> + +<h2 id="Методи">Методи</h2> + +<dl> + <dt>{{domxref("Headers.append()")}}</dt> + <dd>Додає нове значення до існуючого заголовка в об'єкті <code>Headers</code>, або додає заголовок якщо той не існує.</dd> + <dt>{{domxref("Headers.delete()")}}</dt> + <dd>Видаляє заголовок з об'єкта <code>Headers</code>.</dd> + <dt>{{domxref("Headers.entries()")}}</dt> + <dd>Повертає {{jsxref("Iteration_protocols","iterator")}}, дозволяючи проводити через всі пари ключ/значення, що знаходяться в об'єкті.</dd> + <dt>{{domxref("Headers.forEach()")}}</dt> + <dd>Виконує вказану функцію для кожного елементу масива.</dd> + <dt>{{domxref("Headers.get()")}}</dt> + <dd>Повертає {{domxref("ByteString")}} послідовність всіх значеннях заголовків об'єкта <code>Headers</code> з заданим іменем.</dd> + <dt>{{domxref("Headers.has()")}}</dt> + <dd>Повертає логічне значення чи має обєкт <code>Headers</code> певний заголовок</dd> + <dt>{{domxref("Headers.keys()")}}</dt> + <dd>Повертає {{jsxref("Iteration_protocols", "iterator")}}, що дозволяє вам пройтись по всім ключам пар ключ/значення, що містяться в об'єкті.</dd> + <dt>{{domxref("Headers.set()")}}</dt> + <dd>Задає нове значення існуючого заголовку всередині об'єкта <code>Headers</code>, або додає заголовок, якщо той не існує.</dd> + <dt>{{domxref("Headers.values()")}}</dt> + <dd>Повертає {{jsxref("Iteration_protocols", "iterator")}}, що дозволяє вам проходитись по всім значенням пар ключ/значення, які містяться в цьому об'єкті.</dd> +</dl> + +<div class="note"> +<p><strong>Нотатка</strong>: Різниця між {{domxref("Headers.set()")}} і {{domxref("Headers.append()")}} в тому, що якщо вказаний заголовок уже існує і допускає багато значень, {{domxref("Headers.set()")}} перезаписуватиме існуючі значення новим., тоді як {{domxref("Headers.append()")}} буде додавати нове значення в кінець набору значень. Дивіться їх сторінки для прикладу кода.</p> +</div> + +<div class="note"> +<p><strong>Нотатка</strong>: Всі методи Headers видаватимуть помилку <code>TypeError</code> якщо ви спробуєте передати не <a href="https://fetch.spec.whatwg.org/#concept-header-name">Валідне ім'я заголовку</a>. Операції зміни заголовку видаватимуть <code>TypeError,</code> якщо заголовок незмінний {{Glossary("Guard")}}. У разі інших невдач, вийняток не виникатиме.</p> +</div> + +<div class="note"> +<p><strong>Нотатка</strong>: Коли значення Header повторюються вони автоматично сортуються в лексикографічному порядку і значення дубльованих заголовків комбінуються.</p> +</div> + +<h3 id="Застарілі_методи">Застарілі методи</h3> + +<dl> + <dt>{{domxref("Headers.getAll()")}}</dt> + <dd>Використовується для повернення масиву всіх значень заголовка з заданим іменем в об'єкті <code>Headers</code> ; цей метод - видалений із специфікації і натомість тепер {{domxref("Headers.get()")}} повертає всі значення замість одного.</dd> +</dl> + +<h2 id="Приклади">Приклади</h2> + +<p>В наступномуIn the following фрагменті ми створили новий заголовок, використавши конструктор <code>Headers()</code> constructor, додали новий заголовок за допомогою <code>append()</code>, потім повернули значення цього заголовку, використовуючи <code>get()</code>:</p> + +<pre class="brush: js">var myHeaders = new Headers(); + +myHeaders.append('Content-Type', 'text/xml'); +myHeaders.get('Content-Type') // should return 'text/xml' +</pre> + +<p>Те ж можна досягнути передаванням масиву масивів чи літералу об'єкта до конструктора:</p> + +<pre class="brush: js">var myHeaders = new Headers({ + 'Content-Type': 'text/xml' +}); + +// or, using an array of arrays: +myHeaders = new Headers([ + ['Content-Type', 'text/xml'] +]); + +myHeaders.get('Content-Type') // should return 'text/xml' +</pre> + +<h2 id="Специфікація">Специфікація</h2> + +<table class="standard-table"> + <tbody> + <tr> + <th scope="col">Специфікація</th> + <th scope="col">Статус</th> + <th scope="col">Коментар</th> + </tr> + <tr> + <td>{{SpecName('Fetch','#headers-class','Headers')}}</td> + <td>{{Spec2('Fetch')}}</td> + <td> </td> + </tr> + </tbody> +</table> + +<h2 id="Підтримка_браузерів">Підтримка браузерів</h2> + +<div class="hidden">Таблиця підтримки на цій сторінці згенерована з структурованих даних будь ласка прогляньте <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> і надішлінть нам pull request.</div> + +<p>{{Compat("api.Headers")}}</p> + +<h2 id="See_also">See also</h2> + +<ul> + <li><a href="/en-US/docs/Web/API/ServiceWorker_API">ServiceWorker API</a></li> + <li><a href="/en-US/docs/Web/HTTP/Access_control_CORS">HTTP контроль доступу (CORS)</a></li> + <li><a href="/en-US/docs/Web/HTTP">HTTP</a></li> +</ul> + +<p> </p> |