miniprogram network

miniprogramme-réseau

Mini bibliothèque réseau de programmes, fournissant代码自动完成et类型检查, prenant en charge Promise ,重试automatique,缓存,取消, le自定义超时,自动暂停恢复,拦截globale et事件监听, etc.

Redéfinissez l'API réseau de Wechat MiniProgram, y compris IntelliSense et Type Checking complets, avec Promise , retry , Cache , CancelToken , timeout , ensureOnline , interceptors globaux , event listeners et plus encore.

Caractéristiques Fonctions principales

• Prise en charge de la promesse générique
• Réessayer Réessayer automatiquement les erreurs réseau
• Prise en charge du cache sous-jacent (y compris la fusion de requêtes simultanées)
• CancelToken peut annuler l'opération
• Délai d'expiration personnalisé
• Assurez-vous que la demande est envoyée lorsque le réseau est disponible et mettez la demande en pause lorsque vous êtes hors ligne ou lorsque vous passez en arrière-plan.
• l'horodatage enregistre des statistiques chronophages (doit activer la configuration)
• L'interface de rappel native pour chaque demande prend en charge (événement onHeadersReceived ) et (événement onProgressUpdate )
• Intercepteurs intercepteur transformSend / transformRresponse interception de données personnalisées
• Événement global des auditeurs écoutant onSend , onResponse , onRejected , onAbort , onComplete
• Prend en charge la configuration globale par défaut et la configuration individuelle pour chaque demande
• Inférence de type et indice automatique de code (TypeScript)

Exemples Exemples

Installer

npm i miniprogram-network

Javascript

compatible es5

 const Network = require ( 'miniprogram-network' ) ;
// 也可使用 es6 import 写法

// setConfig设置所有网络请求的全局默认配置,一次定义，所有文件中使用均生效
Network . setConfig ( 'baseURL' , 'https://miniprogram-network.newfuture.cc/' )
// 也可Network.REQUEST.Defaults,Network.DOWNLOAD.Defaults,Network.UPLOAD.Defaults 分别设置不同默认配置
Network . REQUEST . Defaults . transformResponse = Network . transformRequestResponseOkData

Network . get ( 'index.html' )
    . then ( res => console . log ( res ) )
    . finally ( ( ) => { console . info ( 'done' ) } ) //支持 finally操作

Network . patch ( 'items/{id}' , { dataKey : 'dataValue' } , {
        params : { id : 123456 } , // 绑定模板参数
        retry : 3 , // 重试3次
    } ) . then ( ( item ) => console . log ( item ) )

Network . download ( 'network/' , 'lcoalpath' , {
        onProgressUpdate : progressUpdateCallBack , //进度回调
        transformResponse : Network . transformDownloadResponseOkData , //状态码2xx成功,返回本地路径
    } ) . then ( path => console . log ( path ) )
    . catch ( console . error )

Manuscrit

Prêt à l'emploi, aucune configuration supplémentaire ou déclaration de type requise

 import { setConfig , REQUEST , download , transformRequestResponseOkData , transformDownloadResponseOkData , delayRetry } from 'miniprogram-network' ;

// setConfig设置所有网络请求的全局默认配置,一次定义，所有文件中使用均生效
setConfig ( 'baseURL' , 'https://miniprogram-network.newfuture.cc/' ) ;
// 也可通过 REQUEST.Defaults,DOWNLOAD.Defaults,UPLOAD.Defaults 分别设置不同默认配置
REQUEST . Defaults . transformResponse = transformRequestResponseOkData ;
// 请求发送失败时, 间隔1s再次重试，最多重试2次
REQUEST . Defaults . retry = delayRetry ( 1000 , 2 ) ;

REQUEST . get ( 'index.html' )
    . then ( res => console . log ( res ) )
    . finally ( ( ) => { console . info ( 'done' ) } ) ; //支持 finally操作

REQUEST . patch < Item > ( 'items/{id}' , { dataKey : 'dataValue' } , {
        params : { id : 123456 } , // 绑定参数
        retry : 3 , // 重试3次
    } ) . then ( ( item : Item ) => console . log ( item ) ) ;

download < string > ( 'network/' , 'lcoalpath' , {
        onProgressUpdate : ( res ) => console . log ( res ) , //进度回调
        transformResponse : transformDownloadResponseOkData , //状态码2xx成功,返回本地路径
    } ) . then ( ( path : string ) => console . log ( path ) )
    . catch ( console . error ) ;

miniprogram-network encapsule uniformément les opérations réseau Pour des opérations et une utilisation détaillées, veuillez consulter le document complet miniprogram-network.

• Si vous n'avez besoin que de l'API d'opération HTTP liée à la requête WeChat, vous ne pouvez utiliser que la demande de mini-programme (documentation ?)
• Si vous n'avez besoin que de l'API de téléchargement liée à WeChat downloadFile, vous pouvez simplement utiliser le miniprogram-downloader (documentation ?)
• Si vous n'avez besoin que de l'API de téléchargement liée à WeChat uploadFile, vous pouvez simplement utiliser miniprogram-uploader (documentation ?)

Conseils de code IntelliSense & Types et vérification de type

Contient des définitions de type complètes, combinées à l'éditeur (VScode), etc., peuvent fournir des invites de code complètes et des fonctions d'achèvement automatique.

Fournit une prise en charge générique pour TypeScript et peut effectuer une vérification complète du type statique.

Forfaits principaux Tous les forfaits

Si vous craignez trop de dépendances de packages, vous pouvez utiliser miniprogram-build pour empaqueter le petit programme et le regrouper dans un seul fichier.

Astuces : Depuis miniprogram-network >= 5.0.0, la couche inférieure n'utilise plus directement miniprogram-queue pour l'encapsulation de file d'attente par défaut. Si nécessaire, vous pouvez vous y référer vous-même, ou utiliser directement la v4.x.

• wx.request prend en charge les files d'attente depuis l'applet de la bibliothèque de base 1.4.0 (2017.07)
• wx.downloadFile prend en charge les files d'attente depuis l'applet de la bibliothèque de base 1.4.0 (2017.07)
• wx.uploadFile prend en charge les files d'attente depuis l'applet de la bibliothèque de base 2.4.1 (2018.11)

• miniprogram-network Collection de bibliothèques de réseaux de mini-programmes tout-en-un
  • Request de miniprogram-request
  • Upload depuis miniprogram-uploader
  • Download depuis miniprogram-downloader
  • Mise en cache réseau et fusion de requêtes
• miniprogram-request bibliothèque de requêtes de mini-programmes
  • Promise prend en charge +enfin+les génériques
  • CancelToken annule le support
  • réessayer erreur réseau réessayer
  • Intercepteurs Interception de requête/réponse personnalisée
  • Écoute d'événement pour les auditeurs
  • Rappel d’en-tête de réponse OnHeadersReceived
  • axios comme l'API
• miniprogram-uploader bibliothèque de téléchargement de mini-programmes
  • Promise prend en charge +enfin+les génériques
  • Annulable Annulable
  • Rappel de progression OnProgressUpdate
  • Rappel d’en-tête de réponse OnHeadersReceived
  • réessayer erreur réseau réessayer
  • Intercepteurs Interception de requête/réponse personnalisée
  • Écoute d'événement pour les auditeurs
• miniprogram-downloader Bibliothèque de téléchargement de mini-programmes
  • Promise prend en charge +enfin+les génériques
  • Annulable Annulable
  • réessayer erreur réseau réessayer
  • Rappel de progression OnProgressUpdate
  • Rappel d’en-tête de réponse OnHeadersReceived
  • Intercepteurs Interception de requête/réponse personnalisée
  • Écoute d'événement pour les auditeurs
• processus et événements d'exploitation du réseau miniprogramme-réseau-cycle de vie
  • écouteur de cycle d'événements
  • intercepteur de cycle d'événements
  • Délai d'expiration personnalisé
  • Pointage d'horodatage
• miniprogram-fetch utilise l'API Fetch dans le mini-programme
  • Prise en charge automatique des files d'attente
• Encapsulation de file d'attente personnalisée miniprogram-queue
  • Injection automatique/gestion manuelle possible
  • Prise en charge de l'opération d'annulation ( abort )
  • Rappel de progression OnProgressUpdate
  • Rappel d’en-tête de réponse OnHeadersReceived
  • Prise en charge du saut de file d'attente
  • Prise en charge du délai d'attente personnalisé