---
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


---

# RequestInit 가져오기 - 범위, 전역

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

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

RequestInit API는 가져오기 요청을 구성하는 옵션을 제공합니다.

RequestInit 객체를 Request() 생성자에 전달하거나 fetch() 함수 호출에 직접 전달할 수 있습니다. RequestInit() 호출로 요청을 구성하고 다른 RequestInit()와 함께 요청을 fetch() 호출에 전달할 수도 있습니다. 두 위치에 동일한 옵션이 설정되어 있을 때 이 작업을 수행하면 fetch() 에 직접 전달된 값이 사용됩니다.  
이 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.RequestInitAPI__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).

## RequestInit 가져오기 - RequestInit {#ariaid-title2}

가져오기 요청을 구성하는 옵션을 설정합니다. RequestInit 객체를 Request() 생성자에 전달하거나 fetch() 함수 호출에 직접 전달할 수 있습니다.

### RequestInit 속성 {#fetch.requestInit-requestInit__section_jcc_fdq_12c}

RequestInit API는 HTTP 요청 동작을 구성하는 데 사용할 수 있는 몇 가지 선택적 속성을 지원합니다. 속성에는 `메서드` (HTTP 메서드), `헤더` (요청 헤더), `본문` (보낼 데이터), `모드` (CORS 모드), `자격 증명` (인증 세부 정보), `캐시` (캐시 동작) 및 `리디렉션`, `참조자` 및 `무결성`과 같은 기타 항목이 포함됩니다. 이러한 옵션을 사용하면 다양한 사용 사례에 대한 요청 동작을 미세 조정할 수 있습니다. 각 속성에 대한 자세한 설명을 읽으려면 다음 문서를 참조하십시오 <https://developer.mozilla.org/en-US/docs/Web/API/RequestInit>.
{#fetch.requestInit-requestInit__table_t5x_2qw_jdc__entry__2}

| 속성 이름 | 설명 |
|-|-|
| 속성보고 | 옵션입니다. 요청의 응답에서 JavaScript 기반 어트리뷰션 소스 또는 어트리뷰션 트리거를 등록할 수 있기를 원하는지를 나타냅니다. `attributionReporting` 은 다음 속성을 포함하는 객체입니다. * eventSourceEligible: 부울입니다. `예`로 설정하면 요청의 응답에서 어트리뷰션 소스를 등록할 수 있습니다. `false`로 설정하면 어트리뷰션 소스로 등록할 수 없습니다. * triggerEligible: 부울. `예`로 설정하면 요청의 응답에서 어트리뷰션 트리거를 등록할 수 있습니다. `false`로 설정하면 어트리뷰션 트리거로 등록할 수 없습니다. {#fetch.requestInit-requestInit__ul_e4n_ljy_12c} 데이터 유형: 객체 |
| 본문 | 옵션입니다. 요청 본문에는 POST 또는 PUT 요청과 같이 서버로 보낼 콘텐츠가 포함되어 있습니다. 허용되는 유형: * 배열 버퍼 * 문자열 * Blob * 데이터 뷰 * 파일 * 양식 데이터 * 읽기 가능한 스트림 * TypedArray * URLSearchParams {#fetch.requestInit-requestInit__ul_f4n_ljy_12c} |
| browsingTopics | 옵션입니다. 현재 사용자에 대해 선택한 주제를 연결된 요청과 함께 Sec-Browsing-Topics 헤더로 보내야 하는지 여부를 나타내는 플래그입니다. 허용되는 값: * 예: 현재 사용자에 대해 선택한 주제를 Sec-Browsing-Topics 헤더로 보내야 합니다. * 아니오: 현재 사용자에 대해 선택한 주제를 Sec-Browsing-Topics 헤더로 보내면 안 됩니다. {#fetch.requestInit-requestInit__ul_nql_b3q_12c} 데이터 유형: 부울 |
| 캐시 | 옵션입니다. 요청에 사용할 캐시 모드입니다. 허용되는 값: * 기본값: 브라우저는 HTTP 캐시에서 요청과 일치하는 응답을 찾습니다. * force-cache: 브라우저가 HTTP 캐시에서 요청과 일치하는 응답을 찾습니다. * no-cache: 브라우저가 HTTP 캐시에서 요청과 일치하는 응답을 찾습니다. * no-store: 브라우저는 먼저 캐시를 찾지 않고 원격 서버에서 리소스를 가져오며 다운로드한 리소스로 캐시를 업데이트하지 않습니다. * only-if-cached: 브라우저가 HTTP 캐시에서 요청과 일치하는 응답을 찾습니다. * reload: 브라우저는 먼저 캐시를 찾지 않고 원격 서버에서 리소스를 가져온 다음 다운로드한 리소스로 캐시를 업데이트합니다. {#fetch.requestInit-requestInit__ul_g4n_ljy_12c} 캐시된 `경우에만` 모드는 요청 모드가 `동일한 원본`인 경우에만 사용할 수 있습니다. 요청의 `리디렉션` 속성이 `follow` 이고 리디렉션이 `동일 원본` 모드를 위반하지 않는 경우 캐시된 리디렉션을 따릅니다. 데이터 유형: 문자열 |
| 자격 증명 | 옵션입니다. 브라우저가 요청과 함께 자격 증명을 보낼지 여부와 Set-Cookie 응답 헤더가 적용되는지 여부를 통제합니다. 자격 증명은 쿠키, TLS 클라이언트 인증서 또는 사용자 이름과 암호를 포함하는 인증 헤더입니다. 허용되는 값: * include: 교차 원본 요청의 경우에도 항상 자격 증명을 포함합니다. 주: 교차 원본 요청에 자격 증명을 포함하면 사이트가 CSRF 공격에 취약해질 수 있으므로 `자격 증명이``포함`하도록 설정되어 있더라도 서버는 응답에 Access-Control-Allow-Credentials를 포함하여 자격 증명 포함에 동의해야 합니다. 또한 이 상황에서 서버는 Access-Control-Allow-Origin 응답 헤더에서 클라이언트의 원본을 명시적으로 지정해야 합니다(즉, `*`는 허용되지 않음). * 생략: 요청에 자격 증명을 보내거나 응답에 자격 증명을 포함하지 마십시오. * same-origin: 동일한 원본 요청에 대해서만 자격 증명을 보내고 포함합니다. {#fetch.requestInit-requestInit__ul_h4n_ljy_12c} 기본값: same-origin 데이터 유형: 문자열 |
| 헤더 | 옵션입니다. 요청에 추가할 헤더(Headers 객체 또는 키가 헤더 이름이고 값이 헤더 값인 객체 리터럴 내에 포함됨)입니다. 많은 헤더는 브라우저에 의해 자동으로 설정되며 스크립트로 설정할 수 없습니다. 이를 금지된 헤더 이름이라고 합니다. `mode` 옵션이 `no-cors`로 설정된 경우 CORS 안전 목록 요청 헤더만 설정할 수 있습니다. 데이터 유형: 문자열 |
| 무결성 | 옵션입니다. 요청의 하위 자원 무결성 값을 포함합니다. 자원을 가져올 때 확인됩니다. 브라우저는 지정된 알고리즘을 사용하여 가져온 자원의 해시를 계산하고, 결과가 지정된 값과 일치하지 않으면 네트워크 오류와 함께 가져오기 요청을 거부합니다. 이 옵션의 형식은 `<hash-algo>-<hash-source>` 이며, * \<hash-algo\>: 는 sha256, sha384 또는 sha512 값 중 하나입니다. * \<hash-source\>: 지정된 해시 알고리즘으로 리소스를 해시한 결과의 Base64 인코딩입니다. {#fetch.requestInit-requestInit__ul_i4n_ljy_12c} 기본값은 빈 문자열입니다. 데이터 유형: 문자열 |
| 연결 유지 | 옵션입니다. 요청이 완료되기 전에 요청을 시작한 페이지가 언로드된 경우 연결된 요청을 중단할지 여부를 나타내는 플래그입니다. `연결 유지` 요청의 본문 크기는 64kibibyte로 제한됩니다. 유효한 값은 다음과 같습니다. * true: 브라우저가 연결된 요청을 중단하지 않습니다. * false: 관련된 요청을 중단합니다. {#fetch.requestInit-requestInit__ul_j4n_ljy_12c} 데이터 유형: 부울 기본값: false |
| 방법 | 옵션입니다. 요청 메서드입니다. 데이터 유형: 문자열 기본값: GET |
| 모드 | 옵션입니다. 요청에 대한 교차 원본 동작을 설정합니다. 유효한 값은 다음과 같습니다. * same-origin: 교차 원본 요청을 허용하지 않습니다. `동일한 원본` 요청이 다른 원본으로 전송되면 네트워크 오류가 발생합니다. * cors: 요청이 교차 원본인 경우 교차 원본 리소스 공유(CORS) 메커니즘을 사용합니다. CORS 안전 목록에 지정된 응답 헤더만 응답에 노출됩니다. * no-cors: 교차 원본 요청에 대해 CORS를 비활성화합니다. 이 옵션에는 다음과 같은 제한 사항이 있습니다. * 메서드는 `HEAD,``GET` 또는 `POST` 중 하나일 수 있습니다. * 헤더는 CORS 안전 목록 요청 헤더일 수 있으며 범위 헤더도 허용되지 않는다는 추가 제한이 있습니다. 이는 서비스 작업자가 추가한 모든 헤더에도 적용됩니다. * 응답이 불투명하므로 헤더와 본문을 JavaScript에서 사용할 수 없으며 상태 코드는 항상 `0`입니다. {#fetch.requestInit-requestInit__ul_l4n_ljy_12c} * 탐색: HTML 탐색에만 사용됩니다. `탐색` 요청은 문서 사이를 탐색하는 동안에만 생성됩니다. {#fetch.requestInit-requestInit__ul_k4n_ljy_12c} 데이터 유형: 문자열 기본값: cors |
| 우선순위 | 옵션입니다. 같은 유형의 다른 요청과 비교했을 때 가져오기 요청의 우선순위를 지정합니다. 유효한 값은 다음과 같습니다. * 자동: 가져오기 우선순위에 대한 사용자 기본 설정이 없습니다. 값이 설정되지 않았거나 잘못된 값이 설정된 경우 사용됩니다. * 높음: 같은 유형의 다른 요청에 비해 우선순위가 높은 가져오기 요청입니다. * 낮음: 같은 유형의 다른 요청에 비해 우선순위가 낮은 가져오기 요청입니다. {#fetch.requestInit-requestInit__ul_m4n_ljy_12c} 데이터 유형: 문자열 기본값: auto |
| redirect | 옵션입니다. 서버가 리디렉션 상태로 응답하는 경우 브라우저의 동작을 결정합니다. 허용되는 값: * follow: 자동으로 리디렉션을 따릅니다. * 오류: 리디렉션 상태가 반환되면 네트워크 오류와 함께 약속을 거부합니다. * manual: 서비스 작업자가 응답을 저장하고 나중에 재생할 수 있도록 거의 모든 필드가 필터링된 응답을 반환합니다. {#fetch.requestInit-requestInit__ul_n4n_ljy_12c} 데이터 유형: 문자열 기본값: 팔로우 |
| 참조자 | 옵션입니다. 요청의 참조자 헤더에 사용할 값을 지정하는 문자열입니다. 허용되는 값 및 데이터 유형: * about:client: `Referrer` 헤더를 요청 컨텍스트(예: 요청을 수행한 페이지의 URL)에 대한 기본값으로 설정합니다. * 빈 문자열: `Referrer` 헤더를 생략합니다. * 동일 원본 상대 또는 절대 URL: `Referrer` 헤더를 지정된 값으로 설정합니다. 상대 URL은 요청을 수행한 페이지의 URL을 기준으로 확인됩니다. {#fetch.requestInit-requestInit__ul_o4n_ljy_12c} 기본값: about:client |
| 참조자 정책 | 옵션입니다. Referrer 헤더에 대한 정책을 설정하는 문자열입니다. 이 옵션의 구문과 의미 체계는 Referrer-Policy 헤더와 정확히 동일합니다. 데이터 유형: 문자열 |
| 신호 | 옵션입니다. AbortSignal입니다. 이 옵션이 설정되어 있으면 해당 `AbortController`에서 abort()를 호출하여 요청을 취소할 수 있습니다. 데이터 유형: 문자열 |
[표 1. RequestInit 속성]

{#fetch.requestInit-requestInit__table_t5x_2qw_jdc} {#fetch.requestInit-requestInit__table_mbs_ppw_jdc__entry__2}

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

{#fetch.requestInit-requestInit__table_mbs_ppw_jdc}  

### fetch()에 옵션 전달

이 예제는 메서드, 본문 및 헤더 옵션을 fetch() 메서드에 직접 전달하는 방법을 보여줍니다.

    async function post() {
      const response = await fetch("https://example.org/post", {
        method: "POST",
        body: JSON.stringify({ username: "example" }),
        headers: {
          "Content-Type": "application/json",
        },
      });

      console.log(response.status);
    }

### Request() 생성자에 옵션 전달 {#fetch.requestInit-requestInit__example_eg5_ckb_jdc}

이 예제는 요청을 만들고 메서드, 본문 및 헤더 옵션을 생성자에 전달하고 요청을 fetch()에 전달하는 방법을 보여줍니다.

    async function post() {
      const request = new Request("https://example.org/post", {
        method: "POST",
        body: JSON.stringify({ username: "example" }),
        headers: {
          "Content-Type": "application/json",
        },
      });

      const response = await fetch(request);

      console.log(response.status);
    }

### Request() 및 fetch() 모두에 옵션 전달 {#fetch.requestInit-requestInit__example_q3w_3kb_jdc}

이 예제에서는 Request() 를 만들고 메서드, 본문 및 헤더 옵션을 생성자에 전달하는 방법을 보여줍니다. 그런 다음 스크립트는 본문 및 참조자 옵션과 함께 요청을 fetch() 로 전달합니다.  
이 경우 요청은 다음 옵션과 함께 전송됩니다.

* 메서드: "POST"
* 헤더: {"Content-Type": "application/json"}
* 본문: '{"username":"example2"}'
* 참조자: ""
{#fetch.requestInit-requestInit__ul_zb4_qkb_jdc}

    async function post() {
      const request = new Request("https://example.org/post", {
        method: "POST",
        headers: {
          "Content-Type": "application/json",
        },
        body: JSON.stringify({ username: "example1" }),
      });

      const response = await fetch(request, {
        body: JSON.stringify({ username: "example2" }),
        referrer: "",
      });

      console.log(response.status);
    }