quickfetch v1.0.0-alpha.5
QuickFetch
a fetch wrapper like axios, support middlewares & abort
1. How to install
npm i quickfetch --save
2. How to use
see test/QuickFetch.test.js
3. API
Classes
Typedefs
QuickFetch ⇐ MiddlewareHolder
QuickFetch
Kind: global class
Extends: MiddlewareHolder
- QuickFetch ⇐ MiddlewareHolder
- new QuickFetch([option])
- instance
- .get(url, [params], [option]) ⇒ Promise
- .post(url, [params], [option]) ⇒ Promise
- .delete(url, [params], [option]) ⇒ Promise
- .put(url, [params], [option]) ⇒ Promise
- .patch(url, [params], [option]) ⇒ Promise
- .sequence(requestPromiseArr) ⇒ Array.<Response>
- .use(type, middleware, [fetchId]) ⇒ object
- static
new QuickFetch(option)
a fetch-based HTTP request tool
Param | Type |
---|---|
option | option |
quickFetch.get(url, params, option) ⇒ Promise
make a GET fetch
Kind: instance method of QuickFetch
Returns: Promise - a Promise that resolves to a Response object
See: QuickFetch#constuctor
Param | Type | Description |
---|---|---|
url | string | |
params | Object | null | an optional params object |
option | option |
quickFetch.post(url, params, option) ⇒ Promise
make a POST fetch
Kind: instance method of QuickFetch
Returns: Promise - a Promise that resolves to a Response object
Param | Type | Description |
---|---|---|
url | string | |
params | Object | null | an optional params object |
option | option |
quickFetch.delete(url, params, option) ⇒ Promise
make a DELETE fetch
Kind: instance method of QuickFetch
Returns: Promise - a Promise that resolves to a Response object
Param | Type | Description |
---|---|---|
url | string | |
params | Object | null | an optional params object |
option | option |
quickFetch.put(url, params, option) ⇒ Promise
make a PUT fetch
Kind: instance method of QuickFetch
Returns: Promise - a Promise that resolves to a Response object
Param | Type | Description |
---|---|---|
url | string | |
params | Object | null | an optional params object |
option | option |
quickFetch.patch(url, params, option) ⇒ Promise
make a PATCH fetch
Kind: instance method of QuickFetch
Returns: Promise - a Promise that resolves to a Response object
Param | Type | Description |
---|---|---|
url | string | |
params | Object | null | an optional params object |
option | option |
quickFetch.sequence(requestPromiseArr) ⇒ Array.<Response>
make batch requests
Kind: instance method of QuickFetch
Param | Type |
---|---|
requestPromiseArr | Array.<Promise> |
quickFetch.use(type, middleware, fetchId) ⇒ object
regist a middleware
Kind: instance method of QuickFetch
Returns: object - actions - { unuse, pause, resume }
Param | Type | Description | ||
---|---|---|---|---|
type | string | QuickFetch.REQUEST | QuickFetch.RESPONSE | QuickFetch.ERROR |
middleware | function | a function looks like (req|res|err, next) => {} | ||
fetchId | string | number | a optional id for special requests |
QuickFetch.REQUEST
Kind: static property of QuickFetch
QuickFetch.RESPONSE
Kind: static property of QuickFetch
QuickFetch.ERROR
Kind: static property of QuickFetch
QuickFetch.EXCEPTION_TIMEOUT
Kind: static property of QuickFetch
QuickFetch.EVENT_FETCH_ABORT
Kind: static property of QuickFetch
QuickFetch.abort(id)
cancel a fetch action
Kind: static method of QuickFetch
Param | Type | Description |
---|---|---|
id | string | number | symbol | fetchId |
MiddlewareHolder ⇐ EventTarget
MiddlewareHolder
Kind: global class
Extends: EventTarget
middlewareHolder.use(type, middleware, fetchId) ⇒ object
regist a middleware
Kind: instance method of MiddlewareHolder
Returns: object - actions - { unuse, pause, resume }
Param | Type | Description | ||
---|---|---|---|---|
type | string | QuickFetch.REQUEST | QuickFetch.RESPONSE | QuickFetch.ERROR |
middleware | function | a function looks like (req|res|err, next) => {} | ||
fetchId | string | number | a optional id for special requests |
option : Object | Null
an optional object for Request API
Kind: global typedef
Properties
Name | Type | Default | Description |
---|---|---|---|
method | string | standard fetch init option | |
credentials | string | "include" | standard fetch init option |
mode | string | "cors" | standard fetch init option |
cache | string | "reload" | standard fetch init option |
headers | Object | standard fetch init option | |
baseURL | string | optional, an url prefix | |
timeout | string | 30000 | optional, timeout |
catchError | boolean | true | optional, if true then just parse error in middleware, otherwise throw it to endpoint |
ignoreBodyMethods | Array | 'get', 'head' | optional |
forceJSON | boolean | false | optional, send body with JSON.stringify() |
fetchId | string | number | symbol | optional, an unique ID of every fetch request | |
signal | AbortSignal | optional, a given signal to cancel the fetch request |
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
5 years ago
5 years ago
5 years ago
5 years ago
5 years ago
5 years ago
5 years ago
5 years ago
5 years ago
5 years ago
5 years ago
5 years ago
5 years ago
5 years ago
5 years ago
5 years ago
5 years ago
5 years ago
5 years ago
5 years ago
5 years ago
5 years ago