---
sourceDocument: 호주 API 참조
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/api-reference

 Release :

    - australia

ft:locale :

    - ko-KR

ft:publication_title :

    - 호주 API 참조

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# 헤더 가져오기 - 범위, 전역

# 헤더 가져오기 - 범위, 전역 {#ariaid-title1}

* 릴리스 버전: Australia
* 
* 업데이트 날짜 2026년 03월 12일
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 12분

헤더 가져오기 API를 사용하면 요청 또는 응답 헤더 목록에서 헤더를 검색, 설정, 추가 및 제거할 수 있습니다.  
이 API는 외부 웹 사이트에서 자원을 가져오기 위한 다양한 작업을 제공하는 Fetch API 집합의 일부입니다. 전체 Fetch API 컬렉션에는 다음이 포함됩니다.

* [페치 - 페치(문자열 자원, 객체 옵션)](https://servicenow-prod.fluidtopics.net/cC_Q8Kzj_58nuPp_71I0eQ#fetch.fetch_S_O "네트워크에서 자원을 가져오는 프로세스를 시작하고 응답을 사용할 수 있게 되면 이행되는 약속을 반환합니다."): 네트워크에서 자원을 가져오는 프로세스를 시작합니다.
* [헤더 가져오기 - 범위, 전역](https://servicenow-prod.fluidtopics.net/TQ_s4qDBI8LI7b~lg02JWw#Fetch.HeadersAPI "헤더 가져오기 API를 사용하면 요청 또는 응답 헤더 목록에서 헤더를 검색, 설정, 추가 및 제거할 수 있습니다."): 요청 및 응답 헤더를 검색하고 수정합니다.
* [가져오기 요청 - 범위, 전역](https://servicenow-prod.fluidtopics.net/tg4UwTEaFmBrnM6TU50UyA#Fetch.RequestAPI "요청 가져오기 API에는 애플리케이션이 서버에서 JSON, 텍스트 또는 이진 데이터와 같은 자원을 비동기적으로 요청하고 응답을 처리할 수 있도록 요청 객체를 만들거나 검색하는 메서드가 포함되어 있습니다. 이 API는 GET, POST, PUT, DELETE 등과 같은 다양한 HTTP 메서드를 지원합니다."): 새 요청 객체를 만듭니다.
* [RequestInit 가져오기 - 범위, 전역](https://servicenow-prod.fluidtopics.net/4xEgjtsDO31eT6OOzCH5jg#Fetch.RequestInitAPI "RequestInit API는 가져오기 요청을 구성하는 옵션을 제공합니다."): 가져오기 요청을 구성하는 옵션을 설정합니다.
* [응답 가져오기 - 범위, 전역](https://servicenow-prod.fluidtopics.net/ct1TFkBEIEoUYJHRNPkDTg#Fetch.ResponseAPI "응답 가져오기 API는 새 응답 객체를 생성하고 요청 가져오기 API 메서드에서 생성된 응답 본문을 처리하는 메서드를 제공합니다."): 새 응답 객체를 생성합니다.
{#Fetch.HeadersAPI__ul_akb_fsf_pdc}

가져오기 작업을 지원하기 위해 시스템 속성인 `glide.hosts.allowlist`를 사용하면 가져오기 메서드가 액세스할 수 있는 호스트를 제어할 수 있습니다. RestMessageV2 및 위에서 언급한 것과 같은 HTTP API에 적용됩니다. `glide.hosts.allowlist`에 대한 자세한 내용은 다음 문서를 참조하십시오[Available system properties](https://www.servicenow.com/docs/access?context=r_AvailableSystemProperties&version=australia&pubname=australia-platform-administration&ft:locale=en-US).

## 헤더 가져오기 - 헤더(init) {#ariaid-title2}

Headers() 생성자는 비어 있는 새 Headers 객체를 만듭니다. 매개변수를 init 사용하여 HTTP 헤더 목록으로 새 Headers 객체를 만들고 미리 채울 수도 있습니다.
주:  
기존 Headers 객체에 헤더를 추가하려면 를 사용합니다 [헤더 가져오기 - append(문자열 이름, 문자열 값)](https://servicenow-prod.fluidtopics.net/TQ_s4qDBI8LI7b~lg02JWw#fetch.headers-append_S_S "Headers 객체 내의 기존 헤더에 새 값을 추가하거나 헤더가 아직 없는 경우 헤더를 추가합니다.").
{#fetch.headers-constructor__table_nzn_3rv_gdc__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 초기화 | 객체 | 옵션입니다. 새 Headers 개체를 미리 채울 HTTP 헤더를 포함하는 객체 리터럴입니다. 유효한 값은 다음과 같습니다. * 문자열 값이 있는 객체 리터럴, * 이름-값 쌍의 배열, * 기존 Headers 객체(새 객체가 기존 객체에서 데이터를 복사하는 경우) 기본값: 빈 Headers 객체를 생성합니다. |
[표 1. 매개변수]

{#fetch.headers-constructor__table_nzn_3rv_gdc}  
다음 예제에서는 Headers() 생성자를 사용하여 헤더가 있거나 없는 새 Headers 개체를 만드는 방법을 보여줍니다.

    //Intializes an empty Headers object.
    var headers = new Headers();

    //Sets the new Headers object with a list of headers.
    var httpHeaders = {
      "Content-Type": "application/json", 
      "X-My-Custom-Header": "XYZ", 
    }; 

    var myHeaders = new Headers(httpHeaders);

## 헤더 가져오기 - append(문자열 이름, 문자열 값) {#ariaid-title3}

Headers 객체 내의 기존 헤더에 새 값을 추가하거나 헤더가 아직 없는 경우 헤더를 추가합니다.
지정된 헤더가 이미 있는 경우 `append()는` 기존 값을 지정된 값으로 변경합니다. 지정된 헤더가 이미 있고 여러 값을 허용하는 경우 `append()` 는 값 세트의 끝에 새 값을 추가합니다. 이전 값을 새 값으로 덮어쓰려면 을 사용합니다 [헤더 가져오기 - set(String name, String value)](https://servicenow-prod.fluidtopics.net/TQ_s4qDBI8LI7b~lg02JWw#fetch.headers-set_S_S "헤더 객체 내에서 기존 헤더의 값을 업데이트하거나, 헤더가 아직 없는 경우 지정된 값으로 새 헤더를 만듭니다.").
{#fetch.headers-append_S_S__table_kpj_czp_jdc__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 이름 | 문자열 | 필수 헤더 객체에 추가할 HTTP 헤더의 이름입니다. |
| 값 | 문자열 | 필수 추가할 HTTP 헤더의 값입니다. |
[표 2. 매개변수]

{#fetch.headers-append_S_S__table_kpj_czp_jdc} {#fetch.headers-append_S_S__table_lpj_czp_jdc__entry__2}

| 유형 | 설명 |
|-|-|
| 없음 |   |
[표 3. 반환]

{#fetch.headers-append_S_S__table_lpj_czp_jdc}  
다음 예제는 append()를 사용하여 헤더를 추가하는 방법을 보여줍니다.

    var myHeaders = new Headers(); // Currently empty
    myHeaders.append("Content-Type", "image/jpeg");
    myHeaders.get("Content-Type"); // Returns 'image/jpeg'

출력:

    "image/jpeg"

다음 예시에서는 여러 값을 허용하는 새 헤더를 추가하는 방법을 보여줍니다.

    var myHeaders = new Headers(); // Currently empty
    myHeaders.append("Accept-Encoding", "deflate");
    myHeaders.append("Accept-Encoding", "gzip");
    myHeaders.get("Accept-Encoding"); // Returns 'deflate, gzip'

출력:

    {"deflate", "gzip"} 

## 헤더 가져오기 - 삭제(문자열 이름) {#ariaid-title4}

현재 Headers 객체에서 헤더를 삭제합니다.
{#fetch.headers-delete_S__table_zpr_f1q_jdc__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 이름 | 문자열 | 헤더 객체에서 삭제할 HTTP 헤더의 이름입니다. |
[표 4. 매개변수]

{#fetch.headers-delete_S__table_zpr_f1q_jdc} {#fetch.headers-delete_S__table_aqr_f1q_jdc__entry__2}

| 유형 | 설명 |
|-|-|
| 없음 |   |
[표 5. 반환]

{#fetch.headers-delete_S__table_aqr_f1q_jdc}  
다음 예제에서는 먼저 append()를 사용하여 Headers 객체에 헤더를 추가한 다음 delete()를 사용하여 동일한 헤더를 삭제하는 방법을 보여줍니다.

    var myHeaders =newHeaders();// Currently empty
    myHeaders.append("Content-Type","image/jpeg");
    myHeaders.get("Content-Type");// Returns 'image/jpeg'

다음 예는 Headers 객체가 이미 삭제된 경우 엔드포인트가 null 값을 반환함을 보여줍니다.

    myHeaders.delete("Content-Type");
    myHeaders.get("Content-Type");// Returns null, as it has been deleted

출력:

    null

## 헤더 가져오기 - entries() {#ariaid-title5}

Headers 객체에 포함된 모든 키-값 쌍(문자열로 표시)을 순환할 수 있는 반복기를 반환합니다.
{#fetch.headers-entries__table_es2_fbq_jdc__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 6. 매개변수]

{#fetch.headers-entries__table_es2_fbq_jdc} {#fetch.headers-entries__table_fs2_fbq_jdc__entry__2}

| 유형 | 설명 |
|-|-|
| 반복기 | 키와 값 쌍이 모두 String 객체인 반복기 객체를 반환합니다. |
[표 7. 반환]

{#fetch.headers-entries__table_fs2_fbq_jdc}  
다음 예제에서는 테스트 Headers 개체를 만든 다음 entries() 메서드를 사용하여 Headers 개체에 있는 모든 값의 반복자를 반환하는 방법을 보여줍니다.

    // Create a test Headers object
    var myHeaders = new Headers();
    myHeaders.append("Content-Type", "text/xml");
    myHeaders.append("Vary", "Accept-Language");

    // Display the key/value pairs
    for (var pair of myHeaders.entries()) {
      console.log(`${pair[0]}: ${pair[1]}`);
    }

출력:

    content-type: text/xml
    vary: Accept-Language

## 헤더 가져오기 - forEach(함수 callbackFn, 객체 thisArg) {#ariaid-title6}

헤더 객체의 각 키/값 쌍당 콜백 함수를 한 번씩 실행합니다.
콜백 함수는 삭제된 키에 대해서는 실행되지 않지만 값이 정의되지 않은 경우에도 기존 키에 대해서는 실행됩니다.
{#fetch.headers-forEach_O_S__table_pjv_xcq_jdc__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 콜백Fn | 함수 | 헤더 객체의 각 키/값 쌍에 대해 실행할 함수입니다. 형식 준수: `callbackFn(문자열 키, 문자열 값)`. |
| callbackFn.value | 문자열 | 헤더 항목의 값입니다. |
| callbackFn.key | 문자열 | 헤더 항목의 이름입니다. |
| callBackFn.object | 머리글 | 반복할 헤더 객체입니다. |
| thisArg | 객체 | `콜백`을 실행할 때 `다음과 같이` 사용할 값입니다. |
[표 8. 매개변수]

{#fetch.headers-forEach_O_S__table_pjv_xcq_jdc} {#fetch.headers-forEach_O_S__table_qjv_xcq_jdc__entry__2}

| 유형 | 설명 |
|-|-|
| 없음 |   |
[표 9. 반환]

{#fetch.headers-forEach_O_S__table_qjv_xcq_jdc}  
다음 예제에서는 Headers 객체의 각 키/값 쌍에 대한 라인을 기록합니다.

    // Create a new test Headers object
    var myHeaders = new Headers();
    myHeaders.append("Content-Type", "application/json");
    myHeaders.append("Cookie", "This is a demo cookie");
    myHeaders.append("compression", "gzip");

    // Display the key/value pairs
    myHeaders.forEach((value, key) => {
      console.log(`${key} ==> ${value}`);
    });

출력:

    compression ==> gzip
    content-type ==> application/json
    cookie ==> This is a demo cookie

## 헤더 페치 - get(문자열 이름) {#ariaid-title7}

지정된 Headers 객체의 모든 헤더 값의 문자열을 반환하거나 헤더가 없는 경우 null을 반환합니다.
{#fetch.headers-get_S__table_lg2_kfq_jdc__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 이름 | 문자열 | 검색하려는 헤더 값이 있는 HTTP 헤더의 이름입니다(대/소문자 구분 안 함). |
[표 10. 매개변수]

{#fetch.headers-get_S__table_lg2_kfq_jdc} {#fetch.headers-get_S__table_mg2_kfq_jdc__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | 검색된 헤더의 값(문자열로 표시) 또는 헤더가 설정되지 않은 경우 null입니다. 헤더가 없는 경우 오류를 반환합니다. 지정된 이름이 HTTP 헤더의 이름이 아닌 경우 유형 오류를 반환합니다. |
[표 11. 반환]

{#fetch.headers-get_S__table_mg2_kfq_jdc}  
다음은 append()를 사용하여 헤더가 여러 개인 헤더 객체를 만든 다음 get() 메서드를 사용하여 헤더 값을 반환하는 방법을 보여줍니다.

    var myHeaders = new Headers(); // Currently empty
    myHeaders.append("Accept-Encoding", "deflate");
    myHeaders.append("Accept-Encoding", "gzip");
    myHeaders.get("Accept-Encoding"); // Returns "deflate, gzip"
    myHeaders
      .get("Accept-Encoding")
      .split(",")
      .map((v) => v.trimStart()); // Returns [ "deflate", "gzip"

출력:

    [ "deflate", "gzip" ]

## 헤더 가져오기 - getSetCookie() {#ariaid-title8}

응답과 연결된 모든 쿠키 세트 헤더를 반환합니다.
{#fetch.headers-getSetCookie__table_spp_hgq_jdc__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 12. 매개변수]

{#fetch.headers-getSetCookie__table_spp_hgq_jdc} {#fetch.headers-getSetCookie__table_tpp_hgq_jdc__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 배열 | 응답과 연결된 모든 Set-Cookie 헤더의 값을 포함하는 문자열 배열입니다. Set-Cookie 헤더가 설정되지 않은 경우 메서드는 빈 배열을 반환합니다. |
[표 13. 반환]

{#fetch.headers-getSetCookie__table_tpp_hgq_jdc}  
다음 스크립트 예시는 getSetCookie() 를 사용하여 응답과 연결된 헤더 값을 반환하는 방법을 보여줍니다.

    var headers = new Headers({
      "Set-Cookie": "name1=value1",
    });

    headers.append("Set-Cookie", "name2=value2");

    headers.getSetCookie();

출력:

    ["name1=value1", "name2=value2"]

## 헤더 가져오기 - has(문자열 이름) {#ariaid-title9}

Headers 객체에 지정된 헤더가 포함되어 있는지 여부를 나타내는 부울을 반환합니다.
{#fetch.headers-has_S__table_bvr_r3q_jdc__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 이름 | 문자열 | 헤더 객체에 있는지 여부를 확인할 HTTP 헤더의 이름입니다. |
[표 14. 매개변수]

{#fetch.headers-has_S__table_bvr_r3q_jdc} {#fetch.headers-has_S__table_cvr_r3q_jdc__entry__2}

| 유형 | 설명 |
|-|-|
| 부울 | 지정된 헤더가 헤더 객체에 있는지 여부를 나타내는 플래그입니다. 지정된 헤더가 유효한 HTTP 헤더 이름이 아닌 경우 TypeError가 반환됩니다. 가능한 값: * true: 헤더가 객체에 있습니다. * false: 헤더가 객체에 없습니다. {#fetch.headers-has_S__ul_om2_lkq_jdc} |
[표 15. 반환]

{#fetch.headers-has_S__table_cvr_r3q_jdc}  
다음 예제에서는 Headers() 및 append() 메서드를 사용하여 Content-Type 헤더가 있는 Headers 객체를 만들고 설정합니다. 그런 다음 예제에서는 has() 메서드를 사용하여 Content-Type 헤더가 Headers 객체에 있지만 Accept-Coding 헤더가 없음을 보여줍니다.

    var myHeaders = new Headers(); // Currently empty
    myHeaders.append("Content-Type", "image/jpeg");
    myHeaders.has("Content-Type"); // Returns true
    myHeaders.has("Accept-Encoding"); // Returns false

출력:

    true
    false

## 헤더 가져오기 - keys() {#ariaid-title10}

Headers 객체에 포함된 모든 키를 순환할 수 있는 반복기를 반환합니다.
메서드를 [헤더 가져오기 - values()](https://servicenow-prod.fluidtopics.net/TQ_s4qDBI8LI7b~lg02JWw#fetch.headers-values "Headers 객체에 포함된 모든 헤더 값을 순환할 수 있는 반복기를 반환합니다.") 사용하여 모든 헤더 키를 반환합니다.
{#fetch.headers-keys__table_hql_jmq_jdc__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 16. 매개변수]

{#fetch.headers-keys__table_hql_jmq_jdc} {#fetch.headers-keys__table_iql_jmq_jdc__entry__2}

| 유형 | 설명 |
|-|-|
| 반복기 | 헤더 키가 문자열로 표시되는 반복기를 반환합니다. |
[표 17. 반환]

{#fetch.headers-keys__table_iql_jmq_jdc}  
다음 예제에서는 키가 있는 Headers 객체를 만든 다음 keys() 메서드를 사용하여 사용 가능한 헤더 목록을 반환하는 방법을 보여줍니다.

    // Create a test Headers object
    var myHeaders = new Headers();
    myHeaders.append("Content-Type", "text/xml");
    myHeaders.append("Vary", "Accept-Language");

    // Display the keys
    for (var key of myHeaders.keys()) {
      console.log(key);
    }

출력:

    content-type
    vary

## 헤더 가져오기 - set(String name, String value) {#ariaid-title11}

헤더 객체 내에서 기존 헤더의 값을 업데이트하거나, 헤더가 아직 없는 경우 지정된 값으로 새 헤더를 만듭니다.
데이터를 덮어쓰지 않고 기존 헤더에 새 값을 추가하려면 메서드를 [헤더 가져오기 - append(문자열 이름, 문자열 값)](https://servicenow-prod.fluidtopics.net/TQ_s4qDBI8LI7b~lg02JWw#fetch.headers-append_S_S "Headers 객체 내의 기존 헤더에 새 값을 추가하거나 헤더가 아직 없는 경우 헤더를 추가합니다.") 사용합니다.
{#fetch.headers-set_S_S__table_q1b_1nq_jdc__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 이름 | 문자열 | 새 값을 설정할 HTTP 헤더의 이름입니다. 지정된 이름이 HTTP 헤더의 이름이 아닌 경우 TypeError를 발생시킵니다. |
| 값 | 문자열 | 지정된 헤더에 대해 설정할 새 값입니다. |
[표 18. 매개변수]

{#fetch.headers-set_S_S__table_q1b_1nq_jdc} {#fetch.headers-set_S_S__table_r1b_1nq_jdc__entry__2}

| 유형 | 설명 |
|-|-|
| 없음 |   |
[표 19. 반환]

{#fetch.headers-set_S_S__table_r1b_1nq_jdc}  
다음 예제는 append()를 사용하여 새 Headers 객체에서 헤더를 설정한 다음 set()을 사용하여 값을 재설정하는 방법을 보여줍니다.

    var myHeaders = new Headers(); // Currently empty
    myHeaders.append("Content-Type", "image/jpeg");
    myHeaders.set("Content-Type", "text/html");

출력:

    text/html

다음 예제에서는 여러 값을 허용할 때 Headers 객체에서 값을 설정하는 방법을 보여줍니다.

    myHeaders.set("Accept-Encoding", "deflate");
    myHeaders.set("Accept-Encoding", "gzip");
    myHeaders.get("Accept-Encoding");

출력:

    gzip

## 헤더 가져오기 - values() {#ariaid-title12}

Headers 객체에 포함된 모든 헤더 값을 순환할 수 있는 반복기를 반환합니다.
메서드를 [헤더 가져오기 - keys()](https://servicenow-prod.fluidtopics.net/TQ_s4qDBI8LI7b~lg02JWw#fetch.headers-keys "Headers 객체에 포함된 모든 키를 순환할 수 있는 반복기를 반환합니다.") 사용하여 모든 헤더 값을 반환합니다.
{#fetch.headers-values__table_s1w_r4q_jdc__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 20. 매개변수]

{#fetch.headers-values__table_s1w_r4q_jdc} {#fetch.headers-values__table_t1w_r4q_jdc__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | 헤더 값이 문자열로 표시되는 반복기를 반환합니다. |
[표 21. 반환]

{#fetch.headers-values__table_t1w_r4q_jdc}  
다음 예제에서는 append() 메서드를 사용하여 여러 헤더가 있는 새 Headers 개체를 처음 만들고 설정한 다음 values() 메서드를 호출하여 새 개체의 모든 헤더 값 목록을 반환하는 방법을 보여줍니다. Console.log()는 라인을 시스템 로그에 기록합니다.

    // Create a test Headers object
    var myHeaders = new Headers();
    myHeaders.append("Content-Type", "text/xml");
    myHeaders.append("Vary", "Accept-Language");

    // Display the values
    for (var value of myHeaders.values()) {
      console.log(value);
    }

출력:

    text/xml
    Accept-Language