weapp.request

weapp.request

Библиотека компонентов сетевых запросов, основанная на расширении wx.request, предоставляемом для апплета WeChat.

Функции

1. Обещание API
2. контроль кэша
3. Перехватчик запросов/ответов

Установить

Для установки рекомендуется использовать npm.

 npm install weapp.request -S

Быстрый старт

Представляем weapp.request

 const request = require ( 'weapp.request' )

1. Отправить GET-запрос

    request ( 'https://api.github.com' ) . then ( onFulfilled ) . catch ( onRejected )

   Поскольку все вызовы request возвращают Promise , вы можете использовать then для дальнейшей обработки результатов запроса и использовать catch для перехвата внутренних ошибок.

2. Отправьте запрос GET и запишите в кеш

    request ( 'https://api.github.com' , { } , {
     cache : true
   } )

3. Отправить POST-запрос

    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'
     }
   } )

4. Глобальная конфигурация

   Варианты конфигурации	тип	иллюстрировать	Необходимый	значение по умолчанию
   базовый URL	String/Undefined	Основной путь запроса	нет
   кэшМаксАге	Number/Undefined	Срок действия кэша, единица времени — секунды.	нет	1800 г.
   действительныйстатускод	Function/Undefined	Допустимый диапазон кода состояния, эта функция принимает один параметр и возвращает Boolean	нет	code => code >= 200 && code < 300

    request . config ( {
     baseUrl : 'https://api.github.com'
   } )

5. Перехватчик запросов/ответов

    // 添加请求拦截器
   request.interceptors.req.use(function (request) {
     request.header['X-Tag'] = 'weapp.request'
     // return request 可以显式地返回一个 request，如果没有 return，则默认返回当前 request
   })
   

   То же самое касается и перехватчиков ответов.

    // 移除请求拦截器
   request.interceptors.req.remove()
   

API

request(url, params, options)

Сделайте GET-запрос.

params : параметры запроса, тип — Object , необязательно.

options : элемент конфигурации, тип — Object , необязательный, может иметь следующие значения атрибутов:

свойство	тип	Необходимый	значение по умолчанию	иллюстрировать
кэш	Boolean/Undefined	нет	undefined	undefined означает получение последних данных с сервера и не записывать их в кеш; true означает сначала получение данных из кеша или если срок действия кеша истек, данные будут получены из. сервер и запись в кеш; false означает сначала получение данных с сервера и запись данных в кеш.
заголовок				То же, что официальный документ WeChat.
тип данных				То же, что официальный документ WeChat.
тип ответа				То же, что официальный документ WeChat.

request.method(url, params, options)

method может быть get , post и т. д.

request.config(options)

options : элементы конфигурации, тип — Object .

Лицензия

Этот код распространяется на условиях лицензии MIT.