مكتبة مكون طلب شبكة تعتمد على ملحق wx.request المقدم لبرنامج WeChat الصغير.
npm install weapp.request -S
const request = require ( 'weapp.request' )
إرسال طلب الحصول على
request ( 'https://api.github.com' ) . then ( onFulfilled ) . catch ( onRejected )
نظرًا لأن جميع استدعاءات request
ستُرجع Promise
، فيمكنك استخدام then
لمعالجة نتائج الطلب بشكل أكبر، واستخدام catch
لالتقاط الأخطاء التي تم إلقاؤها داخليًا.
أرسل طلب GET واكتب إلى ذاكرة التخزين المؤقت
request ( 'https://api.github.com' , { } , {
cache : true
} )
إرسال طلب ما بعد
request . post ( 'https://api.github.com' , {
user : 'afishhhhh'
} )
باستثناء طلبات GET، يجب استدعاء جميع التوابع الأخرى بصيغة request.method
.
وفقًا لوثائق WeChat الرسمية، فإن طريقة POST المذكورة أعلاه Content-Type
الافتراضي هو application/json
، وسيتم إجراء تسلسل للبيانات بتنسيق JSON.
إذا كنت بحاجة إلى إرسال البيانات إلى الخادم في شكل سلسلة استعلام، فيمكنك استخدام طريقة الاتصال التالية، ولا تحتاج إلى كتابة Content-Type
كـ application/x-www-form-urlencoded
بشكل صريح:
request . post ( 'https://api.github.com' , {
form : {
user : 'afishhhhh'
}
} )
التكوين العالمي
خيارات التكوين | يكتب | يوضح | مطلوب | القيمة الافتراضية |
---|---|---|---|---|
baseUrl | String/Undefined | مسار الطلب الأساسي | لا | |
cacheMaxAge | Number/Undefined | فترة صلاحية ذاكرة التخزين المؤقت، الوحدة الزمنية هي ثواني | لا | 1800 |
validStatusCode | Function/Undefined | النطاق القانوني لرمز الحالة، تقبل هذه الوظيفة معلمة واحدة وترجع قيمة Boolean | لا | code => code >= 200 && code < 300 |
request . config ( {
baseUrl : 'https://api.github.com'
} )
اعتراض الطلب/الاستجابة
// 添加请求拦截器
request.interceptors.req.use(function (request) {
request.header['X-Tag'] = 'weapp.request'
// return request 可以显式地返回一个 request,如果没有 return,则默认返回当前 request
})
الشيء نفسه ينطبق على اعتراضات الاستجابة.
// 移除请求拦截器
request.interceptors.req.remove()
request(url, params, options)
تقديم طلب الحصول على.
params
: معلمات الطلب، النوع هو Object
، اختياري.
options
: عنصر التكوين، النوع هو Object
، اختياري، يمكن أن يحتوي على قيم السمات التالية:
ملكية | يكتب | مطلوب | القيمة الافتراضية | يوضح |
---|---|---|---|---|
مخبأ | Boolean/Undefined | لا | undefined | undefined يعني الحصول على أحدث البيانات من الخادم وعدم كتابتها في ذاكرة التخزين المؤقت؛ true يعني الحصول على البيانات من ذاكرة التخزين المؤقت أولاً إذا كانت البيانات غير موجودة في ذاكرة التخزين المؤقت أو انتهت صلاحية ذاكرة التخزين المؤقت، فسيتم الحصول على البيانات منها الخادم وكتابته في ذاكرة التخزين false يعني الحصول على البيانات من الخادم أولاً وكتابتها في ذاكرة التخزين المؤقت |
header | نفس وثيقة WeChat الرسمية | |||
نوع البيانات | نفس وثيقة WeChat الرسمية | |||
نوع الاستجابة | نفس وثيقة WeChat الرسمية |
request.method(url, params, options)
يمكن أن تكون method
get
أو post
أو ما إلى ذلك.
request.config(options)
options
: عناصر التكوين، النوع هو Object
.
يتم توزيع هذا الرمز بموجب شروط وأحكام ترخيص MIT.