aboutsummaryrefslogtreecommitdiff
path: root/files/ko/web/api/xmlhttprequest/setrequestheader/index.html
blob: c7c595e1f1fe3132bd5d937e2c85838ed0ee46fb (plain)
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
---
title: XMLHttpRequest.setRequestHeader()
slug: Web/API/XMLHttpRequest/setRequestHeader
translation_of: Web/API/XMLHttpRequest/setRequestHeader
---
<p>{{APIRef('XMLHttpRequest')}}</p>

<p><strong>XMLHttpRequest.setRequestHeader()</strong> 메소드는 HTTP요청 헤더의 값을 설정합니다. 반드시 <code>setRequestHeader()</code>를 <a href="#open"><code>open()</code></a>뒤에 호출하여야 하며, 또한 <code>send()</code>가 호출되기 전에 호출해야 합니다. 만약 이 메소드가 같은 헤더에 대하여 여러번 호출이 되면, 그 값은 단일 요청 헤더에 병합됩니다.</p>

<p>만약 이것을 이용해 {{HTTPHeader("Accept")}} 헤더를 설정하지 않으면, {{domxref("XMLHttpRequest.send", "send()")}}가 호출될 때 <code>Accept</code> 헤더가 <code>*/*</code>와 함께 전송됩니다.</p>

<p>보안상의 이유로, 어떤 헤더는 오직 사용자 에이전트에 의해서만 관리될 수 있습니다. 이 헤더는 {{Glossary("Forbidden_header_name", "forbidden header names", 1)}}{{Glossary("Forbidden_response_header_name", "forbidden response header names", 1)}}를 포함합니다.</p>

<div class="note">
<p>여러분의 필드에 대해서, 상호교차(cross-domain) 요청시 "<strong>not allowed by Access-Control-Allow-Headers in preflight response</strong>" Exception이 나타날 수 있습니다. 이런 경우, "Access-Control-Allow-Headers"를 서버 측 응답 헤더에 설정하면 됩니다.</p>
</div>

<h2 id="구문">구문</h2>

<pre class="syntaxbox">myReq.setRequestHeader(<var>header</var>, <var>value</var>);
</pre>

<h3 id="매개변수">매개변수</h3>

<dl>
 <dt><code>header</code></dt>
 <dd>설정 될 값을 가진 헤더의 이름</dd>
 <dt><code>value</code></dt>
 <dd>헤더의 본문(body)에 설정될 값</dd>
</dl>

<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('XMLHttpRequest', '#the-setRequestHeader()-method', 'setRequestHeader()')}}</td>
   <td>{{Spec2('XMLHttpRequest')}}</td>
   <td>WHATWG living standard</td>
  </tr>
 </tbody>
</table>

<h2 id="브라우저_호환성">브라우저 호환성</h2>

<div>{{Compat("api.XMLHttpRequest.setRequestHeader")}}</div>

<h2 id="더_보기">더 보기</h2>

<p><a href="/en-US/docs/Web/API/XMLHttpRequest/Using_XMLHttpRequest">Using XMLHttpRequest</a></p>