@allex/io

@allex/io

Promise based HTTP client for the browser and node.js wrapper axios and add jsonp support

Installing

Using npm:

$ npm install @allex/io

Test

//test in browser with karma
$ npm run test
//test in node with mocha
$ npm run node-test

Build

$ npm run build

Example

Performing a request

io[method](url,data,success,fail,config)
io.get(
  // request url
  '/user',
  // optional request query data or request data
  {ID: 12345},
  //handle business success
  function (data) {
    console.log(data);
  },
  //handle business fail when code is not false value or server error
  function (error) {
    console.log(error)
  },
  //extra config  or axios config
  {
    // use application/json with modern api
    emulateJSON:false
  })
  //handle success in promise
  .then(function (data) {
    console.log(data);
  })
  //handle error in promise
  .catch(function (error) {
    console.log(error);
    //error.$ is origin error throw by axios
    console.log(error.$);
  });

response

response data is formatted as

{
  code:0,
  data:"data from server"
  message:"message from server"
}

response error is formatted as

{
  code:"error code",
  data:"error data from server",
  message:"error message from server",
  $:axios throw error
}

config

see https://github.com/mzabriskie/axios#request-config

{
    // use application/json with modern api
    emulateJSON:false
}

axios

//the axios instance is in io.fetch and origin axios is in io.axios
//if you want to use interceptors
// request interceptor
io.interceptors.request.use(function (config) {
    // Do something before request is sent
    return config;
  }, function (error) {
    // Do something with request error
    return Promise.reject(error);
  });

// response interceptor
io.interceptors.response.use(function (response) {
    // Do something with response data
    return response;
  }, function (error) {
    // Do something with response error
    return Promise.reject(error);
  });

instance

create instance with config

const instance = io.create({
  baseURL:"http://www.analysys.cn",
  emulateJSON:false
})

defaults

set default config in all instance

io.config.emulateJSON = false

for more detail see http://git.analysys.cn/npm/io/tree/master/test