تنزيل cute http - تنزيل كود مصدر cute http

cute http

فئات أخرى

1.0.0

تنزيل

لطيف http

Cute-http، مكتبة طلبات http لطيفة، سهلة الاستخدام وبسيطة

يمكنك ضبط عدد مرات إعادة المحاولة بعد انتهاء مهلة الطلب
يمكن تعيين سياسة ذاكرة التخزين المؤقت للحصول على الطلبات
قام Cute بتحسين ذاكرة التخزين المؤقت لطلب الحصول على نفس عنوان URL، إذا ظلت معلمات الاستعلام دون تغيير، فسيتم الحصول على النتيجة المخزنة مؤقتًا أولاً، وإذا لم يكن من الممكن استردادها، فسوف تنتقل إلى الواجهة الخلفية لطلبها سيتم حذف النتيجة المخزنة مؤقتًا السابقة وسيتم استرداد النتيجة التالية، ويطلب العميل نتائج جديدة لمنع تخزين الكثير من البيانات غير المفيدة.
يمكنك بدء عدة طلبات، أو طلبات نشر متعددة، أو طلبات jsonp متعددة، أو عدة أنواع مختلفة من الطلبات
بالنسبة للطلبات المتوازية، لدى Cute استراتيجيتين لمعالجة النتائج.
بشكل افتراضي، يتم إرجاع النتيجة فقط بعد تنفيذ الطلب. حتى إذا حدث خطأ في أحد الطلبات، فلن يؤثر ذلك على الطلبات الأخرى. بالطبع، يحتاج المستخدم إلى اجتياز بيانات النتيجة التي تم إرجاعها في هذا الوقت منهم قد يكون خطأ. يمكن للمستخدمين أيضًا تعيينه بحيث تفشل جميع الطلبات عند بدء طلبات متعددة، طالما كان هناك خطأ في طلب واحد.

كيفية الاستخدام

تثبيت لطيف http

 npm i cute-http --save

يقدم

 import * as cute from 'cute-http';

واجهة برمجة التطبيقات

ثابت

 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 بتخزين النتيجة التي تم إرجاعها عن طريق الحصول عليها في memory مؤقتًا

setConfig

واجهة برمجة التطبيقات ذات المستوى الأعلى، قم بتكوين المعلمات لـ Cute

 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)

multiPost

 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;

}