[{"data":1,"prerenderedAt":1847},["ShallowReactive",2],{"content:\u002Faxios-adapter":3,"section:axios-adapter":1830},{"id":4,"title":5,"aside":6,"authors":7,"badges":8,"banner":7,"body":21,"breadcrumb":6,"collapse":1821,"description":1822,"editLink":6,"extension":1823,"fullpage":1821,"header":7,"icon":1824,"main":7,"meta":1825,"navBadges":7,"navTruncate":1821,"navigation":7,"path":1826,"prevNext":6,"seo":1827,"stem":1828,"toc":6,"__hash__":1829},"content\u002Faxios-adapter\u002Findex.md","axios-adapter",true,null,[9,13,17],{"value":10,"to":11,"target":12},"npm","https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002F@uni-helper\u002Faxios-adapter","_blank",{"value":14,"icon":15,"to":16,"target":12},"source","lucide:code","https:\u002F\u002Fgithub.com\u002Funi-helper\u002Faxios-adapter",{"value":18,"icon":19,"to":20,"target":12},"赞助","lucide:coffee","https:\u002F\u002Fafdian.com\u002Fa\u002Fkejun",{"type":22,"value":23,"toc":1801},"minimark",[24,38,52,62,66,101,154,184,239,242,246,257,260,351,361,370,374,458,462,465,538,552,555,642,653,657,667,677,684,771,777,781,873,883,886,1118,1121,1319,1325,1347,1350,1353,1363,1385,1452,1458,1462,1466,1495,1505,1517,1526,1530,1639,1651,1655,1741,1754,1769,1782,1785,1794,1797],[25,26,29],"alert",{"icon":27,"target":12,"to":28},"lucide:test-tube","\u002Funi-network\u002Fguide\u002Fintroduction",[30,31,32,33,37],"p",{},"在 uni-app 中，",[34,35,36],"code",{},"uni-network","是一个体积性能更好的替代品",[30,39,40,41,44,45,44,48,51],{},"本适配器封装 uni-app 的 ",[34,42,43],{},"uni.request","、",[34,46,47],{},"uni.downloadFile",[34,49,50],{},"uni.uploadFile"," 等接口，让 axios 的编程方式在 uni-app 各平台继续可用。",[30,53,54,55,44,58,61],{},"本包同时为 TypeScript 项目提供全局类型扩展，补充 ",[34,56,57],{},"upload",[34,59,60],{},"download"," 与 uni-app 专有请求参数的类型定义。",[63,64,65],"h2",{"id":65},"平台兼容性",[67,68,69,82],"table",{},[70,71,72],"thead",{},[73,74,75,79],"tr",{},[76,77,78],"th",{},"Vue 版本",[76,80,81],{},"支持情况",[83,84,85,94],"tbody",{},[73,86,87,91],{},[88,89,90],"td",{},"Vue 2",[88,92,93],{},"√",[73,95,96,99],{},[88,97,98],{},"Vue 3",[88,100,93],{},[67,102,103,128],{},[70,104,105],{},[73,106,107,110,113,116,119,122,125],{},[76,108,109],{},"App",[76,111,112],{},"快应用",[76,114,115],{},"微信小程序",[76,117,118],{},"支付宝小程序",[76,120,121],{},"百度小程序",[76,123,124],{},"字节小程序",[76,126,127],{},"QQ 小程序",[83,129,130],{},[73,131,132,142,144,146,148,150,152],{},[88,133,134,135,138,139,141],{},"HBuilderX 3.4.8",[136,137],"br",{},"app-vue",[136,140],{},"app-nvue",[88,143,93],{},[88,145,93],{},[88,147,93],{},[88,149,93],{},[88,151,93],{},[88,153,93],{},[67,155,156,172],{},[70,157,158],{},[73,159,160,163,166,169],{},[76,161,162],{},"钉钉小程序",[76,164,165],{},"快手小程序",[76,167,168],{},"飞书小程序",[76,170,171],{},"京东小程序",[83,173,174],{},[73,175,176,178,180,182],{},[88,177,93],{},[88,179,93],{},[88,181,93],{},[88,183,93],{},[67,185,186,217],{},[70,187,188],{},[73,189,190,193,196,199,202,205,208,211,214],{},[76,191,192],{},"H5-Safari",[76,194,195],{},"Android Browser",[76,197,198],{},"微信浏览器 (Android)",[76,200,201],{},"QQ 浏览器 (Android)",[76,203,204],{},"Chrome",[76,206,207],{},"IE",[76,209,210],{},"Edge",[76,212,213],{},"Firefox",[76,215,216],{},"PC-Safari",[83,218,219],{},[73,220,221,223,225,227,229,231,233,235,237],{},[88,222,93],{},[88,224,93],{},[88,226,93],{},[88,228,93],{},[88,230,93],{},[88,232,93],{},[88,234,93],{},[88,236,93],{},[88,238,93],{},[63,240,241],{"id":241},"安装",[243,244],"pm-install",{"name":245},"@uni-helper\u002Faxios-adapter axios",[30,247,248,249,252,253,256],{},"适配器与 axios 的主版本号和次版本号必须一致。当前适配器版本是 ",[34,250,251],{},"1.21.0","，推荐搭配 ",[34,254,255],{},"axios@^1.21.0"," 使用。",[63,258,259],{"id":259},"基本用法",[261,262,267],"pre",{"className":263,"code":264,"language":265,"meta":266,"style":266},"language-ts shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","import { createUniAppAxiosAdapter } from '@uni-helper\u002Faxios-adapter'\nimport axios from 'axios'\n\naxios.defaults.adapter = createUniAppAxiosAdapter()\n","ts","",[34,268,269,302,320,326],{"__ignoreMap":266},[270,271,274,278,282,286,289,292,295,299],"span",{"class":272,"line":273},"line",1,[270,275,277],{"class":276},"s7zQu","import",[270,279,281],{"class":280},"sMK4o"," {",[270,283,285],{"class":284},"sTEyZ"," createUniAppAxiosAdapter",[270,287,288],{"class":280}," }",[270,290,291],{"class":276}," from",[270,293,294],{"class":280}," '",[270,296,298],{"class":297},"sfazB","@uni-helper\u002Faxios-adapter",[270,300,301],{"class":280},"'\n",[270,303,305,307,310,313,315,318],{"class":272,"line":304},2,[270,306,277],{"class":276},[270,308,309],{"class":284}," axios ",[270,311,312],{"class":276},"from",[270,314,294],{"class":280},[270,316,317],{"class":297},"axios",[270,319,301],{"class":280},[270,321,323],{"class":272,"line":322},3,[270,324,325],{"emptyLinePlaceholder":6},"\n",[270,327,329,331,334,337,339,342,345,348],{"class":272,"line":328},4,[270,330,317],{"class":284},[270,332,333],{"class":280},".",[270,335,336],{"class":284},"defaults",[270,338,333],{"class":280},[270,340,341],{"class":284},"adapter ",[270,343,344],{"class":280},"=",[270,346,285],{"class":347},"s2Zo4",[270,349,350],{"class":284},"()\n",[30,352,353,354,44,357,360],{},"配置完成后，可以照常使用 ",[34,355,356],{},"axios.get",[34,358,359],{},"axios.post"," 等方法。",[30,362,363,365,366,369],{},[34,364,43],{}," 本身没有默认超时。适配器设置了 60 秒默认超时，可以用 ",[34,367,368],{},"config.timeout"," 覆盖。",[371,372,373],"h3",{"id":373},"创建自定义实例",[261,375,377],{"className":263,"code":376,"language":265,"meta":266,"style":266},"import { createUniAppAxiosAdapter } from '@uni-helper\u002Faxios-adapter'\nimport axios from 'axios'\n\nconst instance = axios.create({ adapter: createUniAppAxiosAdapter() })\n",[34,378,379,397,411,415],{"__ignoreMap":266},[270,380,381,383,385,387,389,391,393,395],{"class":272,"line":273},[270,382,277],{"class":276},[270,384,281],{"class":280},[270,386,285],{"class":284},[270,388,288],{"class":280},[270,390,291],{"class":276},[270,392,294],{"class":280},[270,394,298],{"class":297},[270,396,301],{"class":280},[270,398,399,401,403,405,407,409],{"class":272,"line":304},[270,400,277],{"class":276},[270,402,309],{"class":284},[270,404,312],{"class":276},[270,406,294],{"class":280},[270,408,317],{"class":297},[270,410,301],{"class":280},[270,412,413],{"class":272,"line":322},[270,414,325],{"emptyLinePlaceholder":6},[270,416,417,421,424,426,429,431,434,437,440,444,447,449,452,455],{"class":272,"line":328},[270,418,420],{"class":419},"spNyl","const",[270,422,423],{"class":284}," instance ",[270,425,344],{"class":280},[270,427,428],{"class":284}," axios",[270,430,333],{"class":280},[270,432,433],{"class":347},"create",[270,435,436],{"class":284},"(",[270,438,439],{"class":280},"{",[270,441,443],{"class":442},"swJcz"," adapter",[270,445,446],{"class":280},":",[270,448,285],{"class":347},[270,450,451],{"class":284},"() ",[270,453,454],{"class":280},"}",[270,456,457],{"class":284},")\n",[371,459,461],{"id":460},"传递-uni-app-专有参数","传递 uni-app 专有参数",[30,463,464],{},"导入本包后，axios 的请求配置类型会自动扩展出 uni-app 专有参数，可以直接使用：",[261,466,468],{"className":263,"code":467,"language":265,"meta":266,"style":266},"axios.get('https:\u002F\u002Fexample.com\u002Fget', {\n  enableHttp2: true,\n  enableQuic: true,\n  enableCache: true,\n})\n",[34,469,470,495,509,520,531],{"__ignoreMap":266},[270,471,472,474,476,479,481,484,487,489,492],{"class":272,"line":273},[270,473,317],{"class":284},[270,475,333],{"class":280},[270,477,478],{"class":347},"get",[270,480,436],{"class":284},[270,482,483],{"class":280},"'",[270,485,486],{"class":297},"https:\u002F\u002Fexample.com\u002Fget",[270,488,483],{"class":280},[270,490,491],{"class":280},",",[270,493,494],{"class":280}," {\n",[270,496,497,500,502,506],{"class":272,"line":304},[270,498,499],{"class":442},"  enableHttp2",[270,501,446],{"class":280},[270,503,505],{"class":504},"sfNiH"," true",[270,507,508],{"class":280},",\n",[270,510,511,514,516,518],{"class":272,"line":322},[270,512,513],{"class":442},"  enableQuic",[270,515,446],{"class":280},[270,517,505],{"class":504},[270,519,508],{"class":280},[270,521,522,525,527,529],{"class":272,"line":328},[270,523,524],{"class":442},"  enableCache",[270,526,446],{"class":280},[270,528,505],{"class":504},[270,530,508],{"class":280},[270,532,534,536],{"class":272,"line":533},5,[270,535,454],{"class":280},[270,537,457],{"class":284},[30,539,540,541,543,544,547,548,551],{},"这些参数原样透传给 ",[34,542,43],{},"。类型扩展同时为 ",[34,545,546],{},"AxiosResponse"," 补充了 ",[34,549,550],{},"cookies"," 字段。",[371,553,554],{"id":554},"取消请求",[261,556,558],{"className":263,"code":557,"language":265,"meta":266,"style":266},"const controller = new AbortController()\n\naxios.get('\u002Fget', { signal: controller.signal })\n\n\u002F\u002F 需要取消时\ncontroller.abort()\n",[34,559,560,577,581,619,623,629],{"__ignoreMap":266},[270,561,562,564,567,569,572,575],{"class":272,"line":273},[270,563,420],{"class":419},[270,565,566],{"class":284}," controller ",[270,568,344],{"class":280},[270,570,571],{"class":280}," new",[270,573,574],{"class":347}," AbortController",[270,576,350],{"class":284},[270,578,579],{"class":272,"line":304},[270,580,325],{"emptyLinePlaceholder":6},[270,582,583,585,587,589,591,593,596,598,600,602,605,607,610,612,615,617],{"class":272,"line":322},[270,584,317],{"class":284},[270,586,333],{"class":280},[270,588,478],{"class":347},[270,590,436],{"class":284},[270,592,483],{"class":280},[270,594,595],{"class":297},"\u002Fget",[270,597,483],{"class":280},[270,599,491],{"class":280},[270,601,281],{"class":280},[270,603,604],{"class":442}," signal",[270,606,446],{"class":280},[270,608,609],{"class":284}," controller",[270,611,333],{"class":280},[270,613,614],{"class":284},"signal ",[270,616,454],{"class":280},[270,618,457],{"class":284},[270,620,621],{"class":272,"line":328},[270,622,325],{"emptyLinePlaceholder":6},[270,624,625],{"class":272,"line":533},[270,626,628],{"class":627},"sHwdD","\u002F\u002F 需要取消时\n",[270,630,632,635,637,640],{"class":272,"line":631},6,[270,633,634],{"class":284},"controller",[270,636,333],{"class":280},[270,638,639],{"class":347},"abort",[270,641,350],{"class":284},[30,643,644,645,648,649,652],{},"除 ",[34,646,647],{},"AbortController"," 外，也兼容 axios 旧版的 ",[34,650,651],{},"CancelToken","。",[371,654,656],{"id":655},"basic-auth-用户名编码","Basic Auth 用户名编码",[30,658,659,662,663,666],{},[34,660,661],{},"config.auth"," 由适配器直接拼成 ",[34,664,665],{},"Authorization: Basic ..."," 请求头，行为与 axios 1.21 的 xhr、fetch 一致：",[668,669,670,674],"ul",{},[671,672,673],"li",{},"密码始终按 UTF-8 编码。",[671,675,676],{},"用户名默认按原字节发送。",[30,678,679,680,683],{},"用户名含非 ASCII 字符时，必须显式开启 ",[34,681,682],{},"transitional.encodeBasicAuthUsername","：",[261,685,687],{"className":263,"code":686,"language":265,"meta":266,"style":266},"axios.get('\u002Fget', {\n  auth: { username: '用户名', password: 'pwd' },\n  transitional: { encodeBasicAuthUsername: true },\n})\n",[34,688,689,709,747,765],{"__ignoreMap":266},[270,690,691,693,695,697,699,701,703,705,707],{"class":272,"line":273},[270,692,317],{"class":284},[270,694,333],{"class":280},[270,696,478],{"class":347},[270,698,436],{"class":284},[270,700,483],{"class":280},[270,702,595],{"class":297},[270,704,483],{"class":280},[270,706,491],{"class":280},[270,708,494],{"class":280},[270,710,711,714,716,718,721,723,725,728,730,732,735,737,739,742,744],{"class":272,"line":304},[270,712,713],{"class":442},"  auth",[270,715,446],{"class":280},[270,717,281],{"class":280},[270,719,720],{"class":442}," username",[270,722,446],{"class":280},[270,724,294],{"class":280},[270,726,727],{"class":297},"用户名",[270,729,483],{"class":280},[270,731,491],{"class":280},[270,733,734],{"class":442}," password",[270,736,446],{"class":280},[270,738,294],{"class":280},[270,740,741],{"class":297},"pwd",[270,743,483],{"class":280},[270,745,746],{"class":280}," },\n",[270,748,749,752,754,756,759,761,763],{"class":272,"line":322},[270,750,751],{"class":442},"  transitional",[270,753,446],{"class":280},[270,755,281],{"class":280},[270,757,758],{"class":442}," encodeBasicAuthUsername",[270,760,446],{"class":280},[270,762,505],{"class":504},[270,764,746],{"class":280},[270,766,767,769],{"class":272,"line":328},[270,768,454],{"class":280},[270,770,457],{"class":284},[30,772,773,774,652],{},"也可以写在实例默认值上：",[34,775,776],{},"axios.create({ adapter, transitional: { encodeBasicAuthUsername: true } })",[371,778,780],{"id":779},"与-useaxios-一起使用","与 useAxios 一起使用",[261,782,784],{"className":263,"code":783,"language":265,"meta":266,"style":266},"import { createUniAppAxiosAdapter } from '@uni-helper\u002Faxios-adapter'\nimport axios from 'axios'\n\naxios.defaults.adapter = createUniAppAxiosAdapter()\nconst { data, isFinished } = useAxios('\u002Fposts')\n",[34,785,786,804,818,822,840],{"__ignoreMap":266},[270,787,788,790,792,794,796,798,800,802],{"class":272,"line":273},[270,789,277],{"class":276},[270,791,281],{"class":280},[270,793,285],{"class":284},[270,795,288],{"class":280},[270,797,291],{"class":276},[270,799,294],{"class":280},[270,801,298],{"class":297},[270,803,301],{"class":280},[270,805,806,808,810,812,814,816],{"class":272,"line":304},[270,807,277],{"class":276},[270,809,309],{"class":284},[270,811,312],{"class":276},[270,813,294],{"class":280},[270,815,317],{"class":297},[270,817,301],{"class":280},[270,819,820],{"class":272,"line":322},[270,821,325],{"emptyLinePlaceholder":6},[270,823,824,826,828,830,832,834,836,838],{"class":272,"line":328},[270,825,317],{"class":284},[270,827,333],{"class":280},[270,829,336],{"class":284},[270,831,333],{"class":280},[270,833,341],{"class":284},[270,835,344],{"class":280},[270,837,285],{"class":347},[270,839,350],{"class":284},[270,841,842,844,846,849,851,854,856,859,862,864,866,869,871],{"class":272,"line":533},[270,843,420],{"class":419},[270,845,281],{"class":280},[270,847,848],{"class":284}," data",[270,850,491],{"class":280},[270,852,853],{"class":284}," isFinished ",[270,855,454],{"class":280},[270,857,858],{"class":280}," =",[270,860,861],{"class":347}," useAxios",[270,863,436],{"class":284},[270,865,483],{"class":280},[270,867,868],{"class":297},"\u002Fposts",[270,870,483],{"class":280},[270,872,457],{"class":284},[30,874,875,876,652],{},"详见 ",[877,878,882],"a",{"href":879,"rel":880},"https:\u002F\u002Fvueuse.org\u002Fintegrations\u002FuseAxios\u002F",[881],"nofollow","vueuse useAxios",[371,884,885],{"id":885},"上传和下载",[261,887,889],{"className":263,"code":888,"language":265,"meta":266,"style":266},"\u002F\u002F 下载\naxios.download('\u002F')\n\u002F\u002F or\naxios.request({\n  url: '\u002F',\n  method: 'download',\n})\n\n\u002F\u002F 上传\naxios.upload('\u002F', new File([new Blob()], 'fake file'))\n\u002F\u002F or\naxios.request({\n  url: '\u002F',\n  method: 'upload',\n  data: new File([new Blob()], 'fake file'),\n})\n",[34,890,891,896,915,920,934,949,964,971,976,982,1030,1035,1048,1063,1078,1111],{"__ignoreMap":266},[270,892,893],{"class":272,"line":273},[270,894,895],{"class":627},"\u002F\u002F 下载\n",[270,897,898,900,902,904,906,908,911,913],{"class":272,"line":304},[270,899,317],{"class":284},[270,901,333],{"class":280},[270,903,60],{"class":347},[270,905,436],{"class":284},[270,907,483],{"class":280},[270,909,910],{"class":297},"\u002F",[270,912,483],{"class":280},[270,914,457],{"class":284},[270,916,917],{"class":272,"line":322},[270,918,919],{"class":627},"\u002F\u002F or\n",[270,921,922,924,926,929,931],{"class":272,"line":328},[270,923,317],{"class":284},[270,925,333],{"class":280},[270,927,928],{"class":347},"request",[270,930,436],{"class":284},[270,932,933],{"class":280},"{\n",[270,935,936,939,941,943,945,947],{"class":272,"line":533},[270,937,938],{"class":442},"  url",[270,940,446],{"class":280},[270,942,294],{"class":280},[270,944,910],{"class":297},[270,946,483],{"class":280},[270,948,508],{"class":280},[270,950,951,954,956,958,960,962],{"class":272,"line":631},[270,952,953],{"class":442},"  method",[270,955,446],{"class":280},[270,957,294],{"class":280},[270,959,60],{"class":297},[270,961,483],{"class":280},[270,963,508],{"class":280},[270,965,967,969],{"class":272,"line":966},7,[270,968,454],{"class":280},[270,970,457],{"class":284},[270,972,974],{"class":272,"line":973},8,[270,975,325],{"emptyLinePlaceholder":6},[270,977,979],{"class":272,"line":978},9,[270,980,981],{"class":627},"\u002F\u002F 上传\n",[270,983,985,987,989,991,993,995,997,999,1001,1003,1006,1009,1012,1015,1018,1020,1022,1025,1027],{"class":272,"line":984},10,[270,986,317],{"class":284},[270,988,333],{"class":280},[270,990,57],{"class":347},[270,992,436],{"class":284},[270,994,483],{"class":280},[270,996,910],{"class":297},[270,998,483],{"class":280},[270,1000,491],{"class":280},[270,1002,571],{"class":280},[270,1004,1005],{"class":347}," File",[270,1007,1008],{"class":284},"([",[270,1010,1011],{"class":280},"new",[270,1013,1014],{"class":347}," Blob",[270,1016,1017],{"class":284},"()]",[270,1019,491],{"class":280},[270,1021,294],{"class":280},[270,1023,1024],{"class":297},"fake file",[270,1026,483],{"class":280},[270,1028,1029],{"class":284},"))\n",[270,1031,1033],{"class":272,"line":1032},11,[270,1034,919],{"class":627},[270,1036,1038,1040,1042,1044,1046],{"class":272,"line":1037},12,[270,1039,317],{"class":284},[270,1041,333],{"class":280},[270,1043,928],{"class":347},[270,1045,436],{"class":284},[270,1047,933],{"class":280},[270,1049,1051,1053,1055,1057,1059,1061],{"class":272,"line":1050},13,[270,1052,938],{"class":442},[270,1054,446],{"class":280},[270,1056,294],{"class":280},[270,1058,910],{"class":297},[270,1060,483],{"class":280},[270,1062,508],{"class":280},[270,1064,1066,1068,1070,1072,1074,1076],{"class":272,"line":1065},14,[270,1067,953],{"class":442},[270,1069,446],{"class":280},[270,1071,294],{"class":280},[270,1073,57],{"class":297},[270,1075,483],{"class":280},[270,1077,508],{"class":280},[270,1079,1081,1084,1086,1088,1090,1092,1094,1096,1098,1100,1102,1104,1106,1109],{"class":272,"line":1080},15,[270,1082,1083],{"class":442},"  data",[270,1085,446],{"class":280},[270,1087,571],{"class":280},[270,1089,1005],{"class":347},[270,1091,1008],{"class":284},[270,1093,1011],{"class":280},[270,1095,1014],{"class":347},[270,1097,1017],{"class":284},[270,1099,491],{"class":280},[270,1101,294],{"class":280},[270,1103,1024],{"class":297},[270,1105,483],{"class":280},[270,1107,1108],{"class":284},")",[270,1110,508],{"class":280},[270,1112,1114,1116],{"class":272,"line":1113},16,[270,1115,454],{"class":280},[270,1117,457],{"class":284},[371,1119,1120],{"id":1120},"监听进度和响应头",[261,1122,1124],{"className":263,"code":1123,"language":265,"meta":266,"style":266},"axios.download('\u002Ffile', {\n  onHeadersReceived(result) {\n    console.log(result.header)\n  },\n  onDownloadProgress(progressEvent) {\n    console.log(progressEvent.loaded, progressEvent.total)\n  },\n})\n\naxios.upload('\u002Fupload', data, {\n  onUploadProgress(progressEvent) {\n    console.log(progressEvent.loaded, progressEvent.total)\n  },\n})\n",[34,1125,1126,1147,1162,1183,1188,1202,1231,1235,1241,1245,1270,1283,1309,1313],{"__ignoreMap":266},[270,1127,1128,1130,1132,1134,1136,1138,1141,1143,1145],{"class":272,"line":273},[270,1129,317],{"class":284},[270,1131,333],{"class":280},[270,1133,60],{"class":347},[270,1135,436],{"class":284},[270,1137,483],{"class":280},[270,1139,1140],{"class":297},"\u002Ffile",[270,1142,483],{"class":280},[270,1144,491],{"class":280},[270,1146,494],{"class":280},[270,1148,1149,1152,1154,1158,1160],{"class":272,"line":304},[270,1150,1151],{"class":442},"  onHeadersReceived",[270,1153,436],{"class":280},[270,1155,1157],{"class":1156},"sHdIc","result",[270,1159,1108],{"class":280},[270,1161,494],{"class":280},[270,1163,1164,1167,1169,1172,1174,1176,1178,1181],{"class":272,"line":322},[270,1165,1166],{"class":284},"    console",[270,1168,333],{"class":280},[270,1170,1171],{"class":347},"log",[270,1173,436],{"class":442},[270,1175,1157],{"class":284},[270,1177,333],{"class":280},[270,1179,1180],{"class":284},"header",[270,1182,457],{"class":442},[270,1184,1185],{"class":272,"line":328},[270,1186,1187],{"class":280},"  },\n",[270,1189,1190,1193,1195,1198,1200],{"class":272,"line":533},[270,1191,1192],{"class":442},"  onDownloadProgress",[270,1194,436],{"class":280},[270,1196,1197],{"class":1156},"progressEvent",[270,1199,1108],{"class":280},[270,1201,494],{"class":280},[270,1203,1204,1206,1208,1210,1212,1214,1216,1219,1221,1224,1226,1229],{"class":272,"line":631},[270,1205,1166],{"class":284},[270,1207,333],{"class":280},[270,1209,1171],{"class":347},[270,1211,436],{"class":442},[270,1213,1197],{"class":284},[270,1215,333],{"class":280},[270,1217,1218],{"class":284},"loaded",[270,1220,491],{"class":280},[270,1222,1223],{"class":284}," progressEvent",[270,1225,333],{"class":280},[270,1227,1228],{"class":284},"total",[270,1230,457],{"class":442},[270,1232,1233],{"class":272,"line":966},[270,1234,1187],{"class":280},[270,1236,1237,1239],{"class":272,"line":973},[270,1238,454],{"class":280},[270,1240,457],{"class":284},[270,1242,1243],{"class":272,"line":978},[270,1244,325],{"emptyLinePlaceholder":6},[270,1246,1247,1249,1251,1253,1255,1257,1260,1262,1264,1266,1268],{"class":272,"line":984},[270,1248,317],{"class":284},[270,1250,333],{"class":280},[270,1252,57],{"class":347},[270,1254,436],{"class":284},[270,1256,483],{"class":280},[270,1258,1259],{"class":297},"\u002Fupload",[270,1261,483],{"class":280},[270,1263,491],{"class":280},[270,1265,848],{"class":284},[270,1267,491],{"class":280},[270,1269,494],{"class":280},[270,1271,1272,1275,1277,1279,1281],{"class":272,"line":1032},[270,1273,1274],{"class":442},"  onUploadProgress",[270,1276,436],{"class":280},[270,1278,1197],{"class":1156},[270,1280,1108],{"class":280},[270,1282,494],{"class":280},[270,1284,1285,1287,1289,1291,1293,1295,1297,1299,1301,1303,1305,1307],{"class":272,"line":1037},[270,1286,1166],{"class":284},[270,1288,333],{"class":280},[270,1290,1171],{"class":347},[270,1292,436],{"class":442},[270,1294,1197],{"class":284},[270,1296,333],{"class":280},[270,1298,1218],{"class":284},[270,1300,491],{"class":280},[270,1302,1223],{"class":284},[270,1304,333],{"class":280},[270,1306,1228],{"class":284},[270,1308,457],{"class":442},[270,1310,1311],{"class":272,"line":1050},[270,1312,1187],{"class":280},[270,1314,1315,1317],{"class":272,"line":1065},[270,1316,454],{"class":280},[270,1318,457],{"class":284},[30,1320,1321,1322,652],{},"三种请求都支持 ",[34,1323,1324],{},"onHeadersReceived",[30,1326,1327,1330,1331,1334,1335,1338,1339,1342,1343,1346],{},[34,1328,1329],{},"onDownloadProgress"," 与 ",[34,1332,1333],{},"onUploadProgress"," 的事件格式与浏览器端 axios 一致：上传事件带 ",[34,1336,1337],{},"upload: true","，下载事件带 ",[34,1340,1341],{},"download: true","。下载与上传响应的 ",[34,1344,1345],{},"headers"," 是空对象。",[371,1348,1349],{"id":1349},"小程序",[30,1351,1352],{},"自 axios 1.4.0 起，axios 已对小程序环境做了部分兼容处理。",[30,1354,1355,1356,1330,1359,1362],{},"需要在小程序里使用 ",[34,1357,1358],{},"FormData",[34,1360,1361],{},"Blob"," 时，必须安装 polyfill 并启用构建插件：",[261,1364,1368],{"className":1365,"code":1366,"language":1367,"meta":266,"style":266},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","pnpm add miniprogram-formdata miniprogram-blob\n","bash",[34,1369,1370],{"__ignoreMap":266},[270,1371,1372,1376,1379,1382],{"class":272,"line":273},[270,1373,1375],{"class":1374},"sBMFI","pnpm",[270,1377,1378],{"class":297}," add",[270,1380,1381],{"class":297}," miniprogram-formdata",[270,1383,1384],{"class":297}," miniprogram-blob\n",[261,1386,1388],{"className":263,"code":1387,"language":265,"meta":266,"style":266},"\u002F\u002F vite.config.js\nimport uniAxiosAdapter from '@uni-helper\u002Faxios-adapter\u002Fvite'\n\nexport default {\n  plugins: [\n    uniAxiosAdapter()\n  ]\n}\n",[34,1389,1390,1395,1411,1415,1425,1435,1442,1447],{"__ignoreMap":266},[270,1391,1392],{"class":272,"line":273},[270,1393,1394],{"class":627},"\u002F\u002F vite.config.js\n",[270,1396,1397,1399,1402,1404,1406,1409],{"class":272,"line":304},[270,1398,277],{"class":276},[270,1400,1401],{"class":284}," uniAxiosAdapter ",[270,1403,312],{"class":276},[270,1405,294],{"class":280},[270,1407,1408],{"class":297},"@uni-helper\u002Faxios-adapter\u002Fvite",[270,1410,301],{"class":280},[270,1412,1413],{"class":272,"line":322},[270,1414,325],{"emptyLinePlaceholder":6},[270,1416,1417,1420,1423],{"class":272,"line":328},[270,1418,1419],{"class":276},"export",[270,1421,1422],{"class":276}," default",[270,1424,494],{"class":280},[270,1426,1427,1430,1432],{"class":272,"line":533},[270,1428,1429],{"class":442},"  plugins",[270,1431,446],{"class":280},[270,1433,1434],{"class":284}," [\n",[270,1436,1437,1440],{"class":272,"line":631},[270,1438,1439],{"class":347},"    uniAxiosAdapter",[270,1441,350],{"class":284},[270,1443,1444],{"class":272,"line":966},[270,1445,1446],{"class":284},"  ]\n",[270,1448,1449],{"class":272,"line":973},[270,1450,1451],{"class":280},"}\n",[30,1453,1454,1455,652],{},"使用 Vue CLI 时，改用 ",[34,1456,1457],{},"@uni-helper\u002Faxios-adapter\u002Fwebpack",[63,1459,1461],{"id":1460},"api","API",[371,1463,1465],{"id":1464},"createuniappaxiosadapter","createUniAppAxiosAdapter",[261,1467,1469],{"className":263,"code":1468,"language":265,"meta":266,"style":266},"function createUniAppAxiosAdapter(options?: UserOptions): AxiosAdapter\n",[34,1470,1471],{"__ignoreMap":266},[270,1472,1473,1476,1478,1480,1483,1486,1489,1492],{"class":272,"line":273},[270,1474,1475],{"class":419},"function",[270,1477,285],{"class":347},[270,1479,436],{"class":280},[270,1481,1482],{"class":1156},"options",[270,1484,1485],{"class":280},"?:",[270,1487,1488],{"class":1374}," UserOptions",[270,1490,1491],{"class":280},"):",[270,1493,1494],{"class":1374}," AxiosAdapter\n",[30,1496,1497,1498,1501,1502,652],{},"创建适配器实例，可以直接赋值给 ",[34,1499,1500],{},"axios.defaults.adapter","，或传给 ",[34,1503,1504],{},"axios.create({ adapter })",[30,1506,1507,1508,1511,1512,1330,1514,1516],{},"调用时会在 ",[34,1509,1510],{},"Axios"," 原型上挂载 ",[34,1513,57],{},[34,1515,60],{}," 方法，对所有 axios 实例全局生效。",[30,1518,1519,1521,1522,1525],{},[34,1520,1482],{}," 是可选配置对象。当前版本没有可配置字段，仅作预留。返回值是标准的 ",[34,1523,1524],{},"AxiosAdapter"," 函数。",[371,1527,1529],{"id":1528},"axiosupload","axios.upload",[261,1531,1533],{"className":263,"code":1532,"language":265,"meta":266,"style":266},"function upload\u003CT = any, D = any, P = any>(\n  url: string,\n  data?: D,\n  config?: AxiosRequestConfig\u003CD, P>,\n): Promise\u003CAxiosResponse\u003CT, D>>\n",[34,1534,1535,1574,1585,1595,1617],{"__ignoreMap":266},[270,1536,1537,1539,1542,1545,1548,1550,1553,1555,1558,1560,1562,1564,1567,1569,1571],{"class":272,"line":273},[270,1538,1475],{"class":419},[270,1540,1541],{"class":347}," upload",[270,1543,1544],{"class":280},"\u003C",[270,1546,1547],{"class":1374},"T",[270,1549,858],{"class":280},[270,1551,1552],{"class":1374}," any",[270,1554,491],{"class":280},[270,1556,1557],{"class":1374}," D",[270,1559,858],{"class":280},[270,1561,1552],{"class":1374},[270,1563,491],{"class":280},[270,1565,1566],{"class":1374}," P",[270,1568,858],{"class":280},[270,1570,1552],{"class":1374},[270,1572,1573],{"class":280},">(\n",[270,1575,1576,1578,1580,1583],{"class":272,"line":304},[270,1577,938],{"class":1156},[270,1579,446],{"class":280},[270,1581,1582],{"class":1374}," string",[270,1584,508],{"class":280},[270,1586,1587,1589,1591,1593],{"class":272,"line":322},[270,1588,1083],{"class":1156},[270,1590,1485],{"class":280},[270,1592,1557],{"class":1374},[270,1594,508],{"class":280},[270,1596,1597,1600,1602,1605,1607,1610,1612,1614],{"class":272,"line":328},[270,1598,1599],{"class":1156},"  config",[270,1601,1485],{"class":280},[270,1603,1604],{"class":1374}," AxiosRequestConfig",[270,1606,1544],{"class":280},[270,1608,1609],{"class":1374},"D",[270,1611,491],{"class":280},[270,1613,1566],{"class":1374},[270,1615,1616],{"class":280},">,\n",[270,1618,1619,1621,1624,1626,1628,1630,1632,1634,1636],{"class":272,"line":533},[270,1620,1491],{"class":280},[270,1622,1623],{"class":1374}," Promise",[270,1625,1544],{"class":280},[270,1627,546],{"class":1374},[270,1629,1544],{"class":280},[270,1631,1547],{"class":1374},[270,1633,491],{"class":280},[270,1635,1557],{"class":1374},[270,1637,1638],{"class":280},">>\n",[30,1640,1641,1643,1644,1647,1648,1650],{},[34,1642,50],{}," 发送上传请求。",[34,1645,1646],{},"data"," 通常是 ",[34,1649,1358],{}," 实例。",[371,1652,1654],{"id":1653},"axiosdownload","axios.download",[261,1656,1658],{"className":263,"code":1657,"language":265,"meta":266,"style":266},"function download\u003CT = any, D = any, P = any>(\n  url: string,\n  config?: AxiosRequestConfig\u003CD, P>,\n): Promise\u003CAxiosResponse\u003CT, D>>\n",[34,1659,1660,1693,1703,1721],{"__ignoreMap":266},[270,1661,1662,1664,1667,1669,1671,1673,1675,1677,1679,1681,1683,1685,1687,1689,1691],{"class":272,"line":273},[270,1663,1475],{"class":419},[270,1665,1666],{"class":347}," download",[270,1668,1544],{"class":280},[270,1670,1547],{"class":1374},[270,1672,858],{"class":280},[270,1674,1552],{"class":1374},[270,1676,491],{"class":280},[270,1678,1557],{"class":1374},[270,1680,858],{"class":280},[270,1682,1552],{"class":1374},[270,1684,491],{"class":280},[270,1686,1566],{"class":1374},[270,1688,858],{"class":280},[270,1690,1552],{"class":1374},[270,1692,1573],{"class":280},[270,1694,1695,1697,1699,1701],{"class":272,"line":304},[270,1696,938],{"class":1156},[270,1698,446],{"class":280},[270,1700,1582],{"class":1374},[270,1702,508],{"class":280},[270,1704,1705,1707,1709,1711,1713,1715,1717,1719],{"class":272,"line":322},[270,1706,1599],{"class":1156},[270,1708,1485],{"class":280},[270,1710,1604],{"class":1374},[270,1712,1544],{"class":280},[270,1714,1609],{"class":1374},[270,1716,491],{"class":280},[270,1718,1566],{"class":1374},[270,1720,1616],{"class":280},[270,1722,1723,1725,1727,1729,1731,1733,1735,1737,1739],{"class":272,"line":328},[270,1724,1491],{"class":280},[270,1726,1623],{"class":1374},[270,1728,1544],{"class":280},[270,1730,546],{"class":1374},[270,1732,1544],{"class":280},[270,1734,1547],{"class":1374},[270,1736,491],{"class":280},[270,1738,1557],{"class":1374},[270,1740,1638],{"class":280},[30,1742,1743,1745,1746,1749,1750,1753],{},[34,1744,47],{}," 发起下载请求。",[34,1747,1748],{},"response.data"," 是下载文件的临时路径（",[34,1751,1752],{},"tempFilePath","）。",[30,1755,1756,1757,1759,1760,1330,1762,1765,1766,652],{},"泛型与 axios 自带方法对齐：",[34,1758,1547],{}," 是响应数据类型，",[34,1761,1609],{},[34,1763,1764],{},"P"," 分别对应请求数据与 ",[34,1767,1768],{},"params",[30,1770,1771,1772,1775,1776,1779,1780,652],{},"旧版的第二个泛型参数 ",[34,1773,1774],{},"R","（自定义返回类型）已移除。axios 1.19 起其默认值 ",[34,1777,1778],{},"AxiosResponseDefault"," 未导出，无法继续透传 ",[34,1781,1774],{},[63,1783,1784],{"id":1784},"版本策略",[30,1786,1787,1788,1790,1791,652],{},"自 1.4.0 起，适配器的主版本号和次版本号必须与 axios 一致。例如安装了 ",[34,1789,251],{}," 时，axios 必须是 ",[34,1792,1793],{},"1.21.x",[30,1795,1796],{},"这样处理后，适配器始终支持最新的 axios 特性。",[1798,1799,1800],"style",{},"html pre.shiki code .s7zQu, html code.shiki .s7zQu{--shiki-light:#39ADB5;--shiki-light-font-style:italic;--shiki-default:#89DDFF;--shiki-default-font-style:italic;--shiki-dark:#89DDFF;--shiki-dark-font-style:italic}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html pre.shiki code .s2Zo4, html code.shiki .s2Zo4{--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}html pre.shiki code .swJcz, html code.shiki .swJcz{--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178}html pre.shiki code .sfNiH, html code.shiki .sfNiH{--shiki-light:#FF5370;--shiki-default:#FF9CAC;--shiki-dark:#FF9CAC}html pre.shiki code .sHwdD, html code.shiki .sHwdD{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#546E7A;--shiki-default-font-style:italic;--shiki-dark:#676E95;--shiki-dark-font-style:italic}html pre.shiki code .sHdIc, html code.shiki .sHdIc{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#EEFFFF;--shiki-default-font-style:italic;--shiki-dark:#BABED8;--shiki-dark-font-style:italic}html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}",{"title":266,"searchDepth":304,"depth":304,"links":1802},[1803,1804,1805,1815,1820],{"id":65,"depth":304,"text":65},{"id":241,"depth":304,"text":241},{"id":259,"depth":304,"text":259,"children":1806},[1807,1808,1809,1810,1811,1812,1813,1814],{"id":373,"depth":322,"text":373},{"id":460,"depth":322,"text":461},{"id":554,"depth":322,"text":554},{"id":655,"depth":322,"text":656},{"id":779,"depth":322,"text":780},{"id":885,"depth":322,"text":885},{"id":1120,"depth":322,"text":1120},{"id":1349,"depth":322,"text":1349},{"id":1460,"depth":304,"text":1461,"children":1816},[1817,1818,1819],{"id":1464,"depth":322,"text":1465},{"id":1528,"depth":322,"text":1529},{"id":1653,"depth":322,"text":1654},{"id":1784,"depth":304,"text":1784},false,"适用于 Vue2 和 Vue3 的 uniapp Axios 适配器","md","simple-icons:axios",{},"\u002Faxios-adapter",{"title":5,"description":1822},"axios-adapter\u002Findex","S_ze5AMudjPzvj4x7YsKuZeU7br9HBSmNfPagOWkli0",{"id":1831,"title":5,"aside":6,"authors":7,"badges":7,"banner":7,"body":7,"breadcrumb":6,"collapse":1821,"description":7,"editLink":6,"extension":1832,"fullpage":1821,"header":7,"icon":7,"main":7,"meta":1833,"navBadges":7,"navTruncate":1821,"navigation":7,"path":1834,"prevNext":6,"seo":1835,"stem":1836,"toc":1837,"__hash__":1846},"content\u002Faxios-adapter\u002F_dir.yml","yml",{"showTitle":1821},"\u002Faxios-adapter\u002F_dir",{"title":5},"axios-adapter\u002F_dir",{"links":1838},[1839,1842],{"title":1840,"icon":1841,"to":16,"target":12},"点亮星星","lucide:star",{"title":1843,"icon":1844,"to":1845,"target":12},"反馈问题","lucide:github","https:\u002F\u002Fgithub.com\u002Funi-helper\u002Faxios-adapter\u002Fissues","_f8q0Z5153x3SsDcTAf6un1IHhv-YUvvws1x9iZwJM4",1795080993350]