¶Ô±ÈÐÂÎļþ |
| | |
| | | /** |
| | | * @Class Request |
| | | * @description luch-request httpè¯·æ±æä»¶ |
| | | * @version 3.0.7 |
| | | * @Author lu-ch |
| | | * @Date 2021-09-04 |
| | | * @Email webwork.s@qq.com |
| | | * ææ¡£: https://www.quanzhan.co/luch-request/ |
| | | * github: https://github.com/lei-mu/luch-request |
| | | * DCloud: http://ext.dcloud.net.cn/plugin?id=392 |
| | | * HBuilderX: beat-3.0.4 alpha-3.0.4 |
| | | */ |
| | | |
| | | import dispatchRequest from './dispatchRequest' |
| | | import InterceptorManager from './InterceptorManager' |
| | | import mergeConfig from './mergeConfig' |
| | | import defaults from './defaults' |
| | | import { isPlainObject } from '../utils' |
| | | import clone from '../utils/clone' |
| | | |
| | | export default class Request { |
| | | /** |
| | | * @param {Object} arg - å
¨å±é
ç½® |
| | | * @param {String} arg.baseURL - å
¨å±æ ¹è·¯å¾ |
| | | * @param {Object} arg.header - å
¨å±header |
| | | * @param {String} arg.method = [GET|POST|PUT|DELETE|CONNECT|HEAD|OPTIONS|TRACE] - å
¨å±é»è®¤è¯·æ±æ¹å¼ |
| | | * @param {String} arg.dataType = [json] - å
¨å±é»è®¤çdataType |
| | | * @param {String} arg.responseType = [text|arraybuffer] - å
¨å±é»è®¤çresponseTypeãæ¯ä»å®å°ç¨åºä¸æ¯æ |
| | | * @param {Object} arg.custom - å
¨å±é»è®¤çèªå®ä¹åæ° |
| | | * @param {Number} arg.timeout - å
¨å±é»è®¤çè¶
æ¶æ¶é´ï¼åä½ msãé»è®¤60000ãH5(HBuilderX 2.9.9+)ãAPP(HBuilderX 2.9.9+)ã微信å°ç¨åºï¼2.10.0ï¼ãæ¯ä»å®å°ç¨åº |
| | | * @param {Boolean} arg.sslVerify - å
¨å±é»è®¤çæ¯å¦éªè¯ ssl è¯ä¹¦ãé»è®¤true.ä»
Appå®åç«¯æ¯æï¼HBuilderX 2.3.3+ï¼ |
| | | * @param {Boolean} arg.withCredentials - å
¨å±é»è®¤çè·¨åè¯·æ±æ¶æ¯å¦æºå¸¦åè¯ï¼cookiesï¼ãé»è®¤falseãä»
H5æ¯æï¼HBuilderX 2.6.15+ï¼ |
| | | * @param {Boolean} arg.firstIpv4 - å
¨DNSè§£ææ¶ä¼å
使ç¨ipv4ãé»è®¤falseãä»
App-Android æ¯æ (HBuilderX 2.8.0+) |
| | | * @param {Function(statusCode):Boolean} arg.validateStatus - å
¨å±é»è®¤çèªå®ä¹éªè¯å¨ãé»è®¤statusCode >= 200 && statusCode < 300 |
| | | */ |
| | | constructor(arg = {}) { |
| | | if (!isPlainObject(arg)) { |
| | | arg = {} |
| | | console.warn('设置å
¨å±åæ°å¿
é¡»æ¥æ¶ä¸ä¸ªObject') |
| | | } |
| | | this.config = clone({ ...defaults, ...arg }) |
| | | this.interceptors = { |
| | | request: new InterceptorManager(), |
| | | response: new InterceptorManager() |
| | | } |
| | | } |
| | | |
| | | /** |
| | | * @Function |
| | | * @param {Request~setConfigCallback} f - 设置å
¨å±é»è®¤é
ç½® |
| | | */ |
| | | setConfig(f) { |
| | | this.config = f(this.config) |
| | | } |
| | | |
| | | middleware(config) { |
| | | config = mergeConfig(this.config, config) |
| | | const chain = [dispatchRequest, undefined] |
| | | let promise = Promise.resolve(config) |
| | | |
| | | this.interceptors.request.forEach((interceptor) => { |
| | | chain.unshift(interceptor.fulfilled, interceptor.rejected) |
| | | }) |
| | | |
| | | this.interceptors.response.forEach((interceptor) => { |
| | | chain.push(interceptor.fulfilled, interceptor.rejected) |
| | | }) |
| | | |
| | | while (chain.length) { |
| | | promise = promise.then(chain.shift(), chain.shift()) |
| | | } |
| | | |
| | | return promise |
| | | } |
| | | |
| | | /** |
| | | * @Function |
| | | * @param {Object} config - 请æ±é
置项 |
| | | * @prop {String} options.url - 请æ±è·¯å¾ |
| | | * @prop {Object} options.data - 请æ±åæ° |
| | | * @prop {Object} [options.responseType = config.responseType] [text|arraybuffer] - ååºçæ°æ®ç±»å |
| | | * @prop {Object} [options.dataType = config.dataType] - å¦æè®¾ä¸º jsonï¼ä¼å°è¯å¯¹è¿åçæ°æ®å䏿¬¡ JSON.parse |
| | | * @prop {Object} [options.header = config.header] - 请æ±header |
| | | * @prop {Object} [options.method = config.method] - è¯·æ±æ¹æ³ |
| | | * @returns {Promise<unknown>} |
| | | */ |
| | | request(config = {}) { |
| | | return this.middleware(config) |
| | | } |
| | | |
| | | get(url, options = {}) { |
| | | return this.middleware({ |
| | | url, |
| | | method: 'GET', |
| | | ...options |
| | | }) |
| | | } |
| | | |
| | | post(url, data, options = {}) { |
| | | return this.middleware({ |
| | | url, |
| | | data, |
| | | method: 'POST', |
| | | ...options |
| | | }) |
| | | } |
| | | |
| | | // #ifndef MP-ALIPAY |
| | | put(url, data, options = {}) { |
| | | return this.middleware({ |
| | | url, |
| | | data, |
| | | method: 'PUT', |
| | | ...options |
| | | }) |
| | | } |
| | | |
| | | // #endif |
| | | |
| | | // #ifdef APP-PLUS || H5 || MP-WEIXIN || MP-BAIDU |
| | | delete(url, data, options = {}) { |
| | | return this.middleware({ |
| | | url, |
| | | data, |
| | | method: 'DELETE', |
| | | ...options |
| | | }) |
| | | } |
| | | |
| | | // #endif |
| | | |
| | | // #ifdef H5 || MP-WEIXIN |
| | | connect(url, data, options = {}) { |
| | | return this.middleware({ |
| | | url, |
| | | data, |
| | | method: 'CONNECT', |
| | | ...options |
| | | }) |
| | | } |
| | | |
| | | // #endif |
| | | |
| | | // #ifdef H5 || MP-WEIXIN || MP-BAIDU |
| | | head(url, data, options = {}) { |
| | | return this.middleware({ |
| | | url, |
| | | data, |
| | | method: 'HEAD', |
| | | ...options |
| | | }) |
| | | } |
| | | |
| | | // #endif |
| | | |
| | | // #ifdef APP-PLUS || H5 || MP-WEIXIN || MP-BAIDU |
| | | options(url, data, options = {}) { |
| | | return this.middleware({ |
| | | url, |
| | | data, |
| | | method: 'OPTIONS', |
| | | ...options |
| | | }) |
| | | } |
| | | |
| | | // #endif |
| | | |
| | | // #ifdef H5 || MP-WEIXIN |
| | | trace(url, data, options = {}) { |
| | | return this.middleware({ |
| | | url, |
| | | data, |
| | | method: 'TRACE', |
| | | ...options |
| | | }) |
| | | } |
| | | |
| | | // #endif |
| | | |
| | | upload(url, config = {}) { |
| | | config.url = url |
| | | config.method = 'UPLOAD' |
| | | return this.middleware(config) |
| | | } |
| | | |
| | | download(url, config = {}) { |
| | | config.url = url |
| | | config.method = 'DOWNLOAD' |
| | | return this.middleware(config) |
| | | } |
| | | } |
| | | |
| | | /** |
| | | * setConfigåè° |
| | | * @return {Object} - è¿åæä½åçconfig |
| | | * @callback Request~setConfigCallback |
| | | * @param {Object} config - å
¨å±é»è®¤config |
| | | */ |