cb fetch

cb-fetch

콜백 패턴을 따르는 비동기 HTTP 요청을 수행하기 위한 진정한 크로스 브라우 저 및 전방 호환 라이브러리입니다.

목차

• 용법
  • 설치
  • 수입
  • 예
• 지원하다
• 행동 양식
• 속성
• 문제
• 특허

용법

설치

npm

npm install --save cb-fetch

방사

yarn add cb-fetch

jspm

jspm install cb-fetch

나무 그늘

bower install --save cb-fetch

jsDelivr

< script src = " //cdn.jsdelivr.net/combine/npm/@string/isstring/isString.min.js,npm/cb-fetch/index.min.js " type = " text/javascript " ></ script >

수입

AMD

  define(function (require) {
    var request = require('cb-fetch');
  });
  

CJS

표준 준수

  var request = require('cb-fetch')['default'];
  

Node.js 호환

  var request = require('cb-fetch');
  

유이

  YUI({
    modules: { 'is-string': 'path/to/@string/isstring.js' }
  }).use('is-string', 'cb-fetch', function (Y) {
    var request = Y['default'];
  });
  

TS

  import request = require('cb-fetch');
  

글로벌 네임스페이스

이전에 나열된 모듈 등록 방법 중 어느 것도 지원되지 않으면 request 라는 전역 변수가 노출됩니다.

예

 // here's your typical request
request ( 'http://www.example.com?key1=value1&key2=value2' )
  . done ( response => { /* … */ } ) ;

// taking a comprehensive approach is encouraged though
request ( )
  . get ( 'http://www.example.com' )
  . query ( 'key1=value1&key2=value2' )
  . done ( onSuccessCallback , onErrorCallback ) ;

// passing an object offers options not available otherwise
let abort = request ( {
  url :          new URL ( 'http://www.example.com' ) ,
  parameters :   new URLSearchParams ( '_csrf=TOKEN' ) ,
  mode :         'cors' ,
  credentials :  'include' ,
  responseType : 'json'
} ) . get ( '/segment' )
  . query ( { foo : [ 'bar' , 'qux' ] } )
  . pass ( 'Content-Type' , 'application/json' )
  . hook ( 'download' , e => { /* … */ } )
  . done ( {
    success : onSuccessCallback ,
    error :   onErrorCallback ,
    abort :   onAbortCallback
  } ) ;

// forcefully aborts the request
abort ( ) ; 

지원하다

• fetch
• XMLHttpRequest
• XDomainRequest
• 범용 모듈 정의
• 웹DAV
• 타입스크립트
• 흐름

행동 양식

가져오기/헤드/삭제/게시/패치/넣기

 (Options.url?) => Object

질문

 (Options.parameters?) => Object

보내다

 (Options.body?) => Object

훅

로드스타트

 ('loadstart', () => Boolean | Void) => Object

다운로드

 ('download', Object => Any) => Object

로드엔드

 ('loadend', () => Any) => Object

통과하다

 {
  (name: String, value: String),
  (headers: Object | Headers)
} => Object

  // assigns
  . pass ( new Headers ( { key : 'value' } ) )

  // appends
  . pass ( { key : 'value' } )

  // sets
  . pass ( 'key' , 'value' )

완료

 {
  (onSuccess?: Function, onError?: Function),
  ({
    success?:  Function,
    error?:    Function,
    timeout?:  Function,
    abort?:    Function
  })
} => () => Void,
  throws: TypeError

속성

요청 옵션

재산	기본	값
몸	null	BufferSource, Blob, Document², FormData, 문자열, URLSearchParams, ReadableStream
신임장	'동일 출처'	'포함', '생략'⁶, '동일 출처'
헤더	{}	개체, 헤더³
방법	'얻다'	끈
방법	'동일 출처'	'cors', 'no-cors'1, '동일 출처'
비밀번호	null	끈
매개변수		URLSearchParams, 개체, 문자열
응답미디어 유형²		끈
응답 유형		'text', 'json', 'blob', 'document', 'arraybuffer', 'formdata'1, 'moz-blob', 'moz-chunked-arraybuffer', 'moz-chunked-text', 'msxml- 문서'
시간 초과	0	ℕ
사용자 이름	null	끈
URL	위치.href	문자열, URL
멀티파트7	거짓	부울
터널링⁵	거짓	부울
XSLP패턴⁴	거짓	부울

진행 이벤트

재산	유형
큰 덩어리	문자열, ArrayBuffer, Blob, Uint8Array, null
골재	문자열, ArrayBuffer, Blob, Uint8Array, null
짐을 실은	ℕ
총	ℕ
길이계산 가능	부울

응답

재산	유형
몸	객체, 문자열, 문서, ArrayBuffer, Blob, FormData1, ReadableStream1, null
헤더	물체
사례	XMLHttpRequest, XDomainRequest, 응답, AnonXMLHttpRequest
상태 코드	ℕ
상태텍스트	끈
URL	끈

_{^{¹ 가져오기만 가능
² XHR만 해당
³ Gecko 34–43 제외
⁴ MSXML 3.0 전용
⁵ 메소드 재정의
⁶ 가져오기, Gecko 16+, Presto/2.10.232–2.12.423
7 게코 1.7β–22}}

문제

예약된 키워드 delete

ES5 이전 환경에서는 삭제 메소드를 사용하려면 대괄호 표기법을 사용해야 합니다.

도마뱀붙이

Gecko 1.9.1–20 기반 브라우저에서 노출된 응답 헤더를 headers 속성에 채우려면 다음 조건을 충족해야 합니다.

• Access-Control-Expose-Headers 응답 헤더가 자체적으로 노출됩니다.
• Access-Control-Expose-Headers 필드 값이 * 아닙니다.
• mode cors 로 설정됨

삼지창

XDomainRequest 본질적인 제한 사항

• GET 및 POST 메소드만 지원
• 요청 헤더를 설정할 수 없습니다
• 자격 증명 없음
• 동일한 계획 제한
• 정보 및 리디렉션 상태 코드 클래스는 오류로 간주됩니다.
• 응답의 상태 코드와 상태 텍스트가 제공되지 않습니다.
• 동일 출처 요청은 또한 서버가 * 또는 요청 문서의 정확한 URL의 Access-Control-Allow-Origin 헤더로 응답하도록 요구합니다.

개인정보 보호를 위한 플랫폼

Internet Explorer의 기본 설정은 P3P 압축 정책 선언이 사용자 정의 HTTP 응답 헤더를 통해 포함되지 않는 한 ^제 3자 쿠키의 사용을 제한합니다. 따라서 쿠키가 만족스럽지 못한 것으로 간주되면 "include" 자격 증명 모드를 완전히 적용할 수 없습니다.

특허