WEBAPI

settings_applicationsWindowOrWorkerGlobalScope

WEBAPI

Draft
  • account_tree
  • bug_report

PromiseresponsePromisefetch(USVStringresource | Requestrequest[, Objectinit])

네트워크에서 리소스를 가져오는 프로세스를 응답을 사용할 수 있게 되면 Promise 객체를 반환한다. Promise의 Response은 요청에 대한 응답을 나타내는 객체로 해석된다.

구문

기본형식
const responsePromise = fetch(resource[, init])

매개 변수

USVStringresource필수

가져오고자 하는 리소스의 경로를 지정한다.

또는 다른 타입
Requestrequest필수

Request 객체

Objectinit선택

네트워크 요청에 지정할 사용자 지정 설정이 포함된 객체이며 가능한 옵션은 아래와 같다. 필요한 경우 이외는 일반적으로 설정하지 않아도 된다.

  • method
    • 요청 방식을 GET, POST 중에서 선택한다.
  • header
    • 요청에 추가려는 header
  • body
    • 요청에 추가하려는 본문
    • Blob, BufferSource, FormData, URLSearchParams, USVString 또는 ReadableStream 객체일 수 있다.
  • mode
    • 요청에 사용하려는 모드(예: cors, no-cors 또는 same-origin)
  • credentials
    • 요청에 사용하려는 요청 자격 증명
  • cache
    • 요청에 사용하려는 cache 모드
  • redirect
    • 사용할 리다이렉션 모드: follow(자동으로 리다이렉션 따르기), error(리다이렉션이 발생할 경우 오류와 함께 중단), manual(리다이렉션 수동 처리)
  • referrer
    • 요청의 리퍼러를 지정: USVString을 갖는 동일한 출처의 URL 또는 빈 문자열일 수 있다.
  • referrerPolicy
    • 요청에 사용할 리퍼러 정책을 지정: no-referrer, no-referrer-when-downgrade, same-origin, origin, strict-origin, origin-when-cross-origin, strict-origin-when-cross-origin, unsafe-url
  • integrity
    • 요청의 하위 리소스 무결성을 값을 포함한다.
  • keepalive

    • 옵션을 사용하면 요청이 페이지보다 오래 지속될 수 있다.
  • signal
    • AbortString 객체 인스턴스: 요청후 AbortController를 통해 중단을 할 수 있다.

반환

PromiseresponsePromise

반환된 Promise 객체는 실제로 요청한 데이터가 아닌 HTTP의 응답을 의미한다. 응답에서 JSON을 추출하기 위해서는 json() 메소드를 사용한다.

예제

(1) 서버에서 값을 가져오는 경우의 샘플 코드

(2) 서버에서 값을 전송하는 경우의 샘플 코드

지원 웹브라우저