Modern await/async HTTP client library built on top of (axios)[https://github.com/axios/axios] and inspired by golang's syntax.
Install
npm i xhr-asyncor
yarn add xhr-asyncThen in your script:
import xhr from 'xhr-async'API
const {
status,
statusText,
error,
headers,
response,
request
} = await xhr.[get | post | delete | head | options | trace](url, options)Most of the time, you'd probably need status, error, and response back from a request.
options is exactly the same as axios' options.
xhr-async supports response alias, for example instead of:
const { response: ip } = await xhr.get('https://httpbin.org/ip')You can do:
const { ip } = await xhr.get('https://httpbin.org/ip').as('ip')To make it easier to handle network connectivity, xhr-async provides three special statuses UNREACHABLE, ABORTED, and TIMEOUT:
const { status } = await xhr.get('https://httpbin.org/ip')
if (status === xhr.UNREACHABLE) {
// server is unreachable
} else if (status === xhr.ABORTED) {
// request is aborted by xhr.abort()
} else if (status === xhr.TIMEOUT) {
// request is timeout
}xhr.defaults
xhr.defaults is used to configure global configuration. It is exactly the same as axios' defaults except that axios' transformRequest and transformResponse are currently not supported.
xhr.abort
xhr-async supports request cancellation. You can abort an ongoing request, or abort a group of requests.
Abort a single request
let xhrReq
const { status } = await xhr.get('https://httpbin.org/delay/2', {
ref: req => xhrReq = req
})
// At some place when you want to abort a request
xhrReq.abort()Abort a group of requests
Assume you made two requests to some endpoints, at some point you want to abort all ongoing requests of those endpoints. First you need to pass the same group name to the requests, then call xhr.abort(GROUP_NAME).
let requestGroup = 'myRequestGroup'
const { status } = await xhr.get('https://httpbin.org/delay/2', {
group: requestGroup
})
const { status } = await xhr.get('https://httpbin.org/headers', {
group: requestGroup
})
// At some place when you want to abort all requests that belong to `requestGroup` group:
xhrReq.abort(requestGroup)If you want to abort ALL ongoing request being made by xhr-async, you can call xhr.abort() without any parameters.
xhr.abort()Examples
GET
const { response, status } = await xhr.get('https://httpbin.org/ip')POST
const {
response,
status
} = await xhr.post('https://httpbin.org/post', {
data: {
name: 'xhr-async',
timestamp: new Date()
}
})before/after hooks
Similar to axios' request and response interceptors, xhr-async support before and after hooks.
xhr.before(({ url, params, headers = {}, data }) => {
headers.Authorization = 'Bearer 1234567890'
})xhr.after(({ status, statusText, headers, response, error, request }) => {
if (status === 401) {
// redirect to login page
}
})Retry (TBD)
retry: number (TBD)
retry: function (TBD)
ref.retryImmediately (TBD)
Best Practices (TBD)
License
MIT