cute http Скачать - cute http скачать исходный код

cute http

Другие категории

1.0.0

Скачать

милый-http

cute-http, симпатичная библиотека HTTP-запросов, простая в использовании и простая

Вы можете установить количество повторов после таймаута запроса.
Политика кэширования может быть установлена для запросов на получение.
Cute оптимизировал кеш. Для запроса на получение того же URL-адреса, если параметры запроса остаются неизменными, сначала будет получен кэшированный результат. Если его невозможно получить, он будет отправлен на серверную часть для его запроса. при изменении предыдущий кэшированный результат будет удален и будет получен следующий. Клиент запрашивает новые результаты, чтобы предотвратить кэширование слишком большого количества ненужных данных.
Вы можете инициировать несколько запросов на получение, несколько запросов на публикацию, несколько запросов jsonp или несколько разных типов запросов.
Для параллельных запросов cute имеет две стратегии обработки результатов.
По умолчанию результат возвращается только после выполнения запроса. Даже если в одном из запросов произойдет ошибка, это не повлияет на другие запросы. Конечно, пользователю в это время необходимо просмотреть возвращенные данные результата, потому что один из них. из них может быть ошибка. Пользователи также могут настроить его так, чтобы при инициировании нескольких запросов, если в одном запросе есть ошибка, все завершались неудачно.

Как использовать

Установите cute-http

 npm i cute-http --save

представлять

 import * as cute from 'cute-http';

API

постоянный

 const {ONE_ERROR_ABORT_ALL, KEEP_ALL_BEEN_EXECUTED, LOCAL_STORAGE, MEMORY} = cute.const;

ONE_ERROR_ABORT_ALL ошибка, прерываем все запросы
KEEP_ALL_BEEN_EXECUTED Ошибка не повлияет на другие запросы. Вызывающий должен самостоятельно обработать возвращенную ошибку.
Кэши LOCAL_STORAGE получают возвращаемые результаты в localStorage
MEMORY кэширует результат, возвращаемый get, в memory

setConfig

API верхнего уровня, настройка параметров для милых

 cute setConfig({
  retryCount: number,//重试次数
  timeout: 1900,//超时时间（毫秒）
  debug:true,//打开debug模式
  // cacheType: MEMORY, // 默认无，如果开启了缓存，cute只针对get请求做缓存，如需穿透缓存，可以对query参数加随机值，或者调用cute.get时，配置第二个参数{cacheType:null}，表示针对这一次调用不读取缓存值
  // failStrategy: ONE_ERROR_ABORT_ALL, //不设置的话，cute默认采用KEEP_ALL_BEEN_EXECUTED
})

мульти

 /**
 * 发起多个post请求
 * @param {Array<{type:'post', url:string, data:object} | {type:'get', url:string} | {type:'jsonp', url:string} >} items
 * @param {{failStrategy?:number, retryCount?:number, callbackParamName?:string, [otherAxiosConfigKey]:any}} extendedAxiosConfig
 * otherAxiosConfigKey @see https://github.com/axios/axios
 */
cute.multi(urls, extendedAxiosConfig)

получать

 // data 会被自动stringify拼接到url末尾
cute.get(url:string, data:string|object, extendedAxiosConfig:ExtendedAxiosConfig)

multiGet

 cute.multiGet(urls:string[] | {url:string, data:string|object}[], extendedAxiosConfig:ExtendedAxiosConfig)

почта

 cute.post(url:string, data:object, extendedAxiosConfig:ExtendedAxiosConfig)

мультипост

 cute.multiPost({url:string, data:object}[], extendedAxiosConfig:ExtendedAxiosConfig)

jsonp

 // data 会被自动stringify拼接到url末尾
cute.jsonp(url:string, data:string|object, extendedAxiosConfig:ExtendedAxiosConfig)

multiJsonp

 cute.multiJsonp(urls:string[] | {url:string, data:string|object}[], extendedAxiosConfig:ExtendedAxiosConfig)

Следующий код находится в файле test/test-api.js. Пользователи могут выполнить узел ${your_test_dir}/test-api.js, чтобы увидеть эффект.

Конечно, вы также можете закомментировать определенные коды и увидеть эффект только одного из них.

 const cute = require('../index');
const {ONE_ERROR_ABORT_ALL, KEEP_ALL_BEEN_EXECUTED, MEMORY} = cute.const;
const axios = cute.axios;//这个是axios模块的引用

cute.setConfig({
  retryCount: 3,//设置重试次数
  timeout: 1900,//设置超时时间
  debug: true,
  dataVerifyRule: {//设置通用的响应数据校验规则，只支持校验json对象的第一层key的值和类型的校验
    data: 'object',
    code: 'number',
    message: 'string',
  },
  pathDataVerifyRule:{//对某些请求设置独立的数据校验规则
    '/staff/foo':{
      reply:'object',
      msg:'string',
    }
  }
  cacheType: MEMORY, // 值为 'memory' | 'localStorage' 默认无
  failStrategy: KEEP_ALL_BEEN_EXECUTED, //不设置的话，cute默认采用ONE_ERROR_ABORT_ALL
})

const updateBook = 'http://localhost:8888/update-book';
const getBooksByUid = uid => `http://localhost:8888/get-books?uid=${uid}`;

async function main(){
  const result1 = await cute.get(getBooksByUid(1));
  const books = result.result1;

  const result2 = await cute.multiGet([getBooksByUid(1), getBooksByUid(2)]);
  const [reply1, reply2] = result2;

  const result3 = await cute.post(updateBook, {id:1, name:'zk'});
  const updateReply = result.result3;

  const result4 = await cute.multiPost([{url:updateBook, body:{id:1, name:'zk'}}, {url:updateBook, body:{id:2, name:'wow'}}]);
  const [updateReply1, updateReply2] = result4;

}