files/uk/web/http/headers/if-match/index.html


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87

---
title: If-Match
slug: Web/HTTP/Headers/If-Match
translation_of: Web/HTTP/Headers/If-Match
original_slug: Web/HTTP/Заголовки/If-Match
---
<div>{{HTTPSidebar}}</div>

<p><strong><code>If-Match</code></strong> HTTP заголовок запиту робить запит умовним. Для {{HTTPMethod("GET")}} і {{HTTPMethod("HEAD")}} методів, сервер поверне запитаний ресурс тільки якщо співпадає обидва <code>ETags</code>. Для методу {{HTTPMethod("PUT")}} чи інших небезпечних методів, виконається тільки завантаження файлу.</p>

<p>Порівняння коду {{HTTPHeader("ETag")}} може використовувати <em>суворий алгоритм порівняння</em>, мається на увазі повна перевірка байт в байт. Ця функція використовує  <code>W/</code> префікс на початку <code>ETag</code>.</p>

<p>Існує два загальних випадки використання: </p>

<ul>
 <li>Для {{HTTPMethod("GET")}} і {{HTTPMethod("HEAD")}} методів, використовується з додатковим {{HTTPHeader("Range")}} заголовком, це гарантує що усі ranges запити надходять  з того самого джерела. В іншому випадку буде повернуто статус {{HTTPStatus("416")}}<code> </code>(Range Not Satisfiable).</li>
 <li>Для інших випадків, і частково для {{HTTPMethod("PUT")}}, <code>If-Match</code> можуть бути використані <a href="https://www.w3.org/1999/04/Editing/#3.1">порівняння наявності файлу</a>. В такому випадку можно дізнатись чи якісь зміни ресурсу, які користувач намагається завантажити, не змінено з того часу як вони були розташовані. Якщо запит не буде виконано, повернеться статус {{HTTPStatus("412")}} (Precondition Failed).</li>
</ul>

<table class="properties">
 <tbody>
  <tr>
   <th scope="row">Тип заголовку</th>
   <td>{{Glossary("Request header")}}</td>
  </tr>
  <tr>
   <th scope="row">{{Glossary("Forbidden header name")}}</th>
   <td>Ні</td>
  </tr>
 </tbody>
</table>

<h2 id="Синтаксис">Синтаксис</h2>

<pre class="syntaxbox">If-Match: &lt;etag_value&gt;
If-Match: &lt;etag_value&gt;, &lt;etag_value&gt;, …
</pre>

<h2 id="Вказники">Вказники</h2>

<dl>
 <dt>&lt;etag_value&gt;</dt>
 <dd>Значення тегів унікально представляють запитанні ресурси. Це строки ASCII символів розташовані поміж подвійних лапок (наприклад <code>"675af34563dc-tr34"</code>) і можуть мати префікс <code>W/</code> якщо потрібно використання суворого алгоритму порівняння.</dd>
 <dt><code>*</code></dt>
 <dd>Зірочка для представлення будь якого ресурсу. </dd>
</dl>

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

<pre>If-Match: "bfc13a64729c4290ef5b2c2730249c88ca92d82d"

If-Match: W/"67ab43", "54ed21", "7892dd"

If-Match: *
</pre>

<h2 id="Стандарт">Стандарт</h2>

<table class="standard-table">
 <tbody>
  <tr>
   <th scope="col">Specification</th>
   <th scope="col">Title</th>
  </tr>
  <tr>
   <td>{{RFC("7232", "If-Match", "3.1")}}</td>
   <td>Hypertext Transfer Protocol (HTTP/1.1): Conditional Requests</td>
  </tr>
 </tbody>
</table>

<h2 id="Сумісність_з_оглядачами">Сумісність з оглядачами</h2>

<p class="hidden">The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> and send us a pull request.</p>

<p>{{Compat("http.headers.If-Match")}}</p>

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

<ul>
 <li>{{HTTPHeader("ETag")}}</li>
 <li>{{HTTPHeader("If-Unmodified-Since")}}</li>
 <li>{{HTTPHeader("If-Modified-Since")}}</li>
 <li>{{HTTPHeader("If-None-Match")}}</li>
 <li>{{HTTPStatus("416")}}<code> Range Not Satisfiable</code></li>
 <li>{{HTTPStatus("412")}}<code> Precondition Failed</code></li>
</ul>