[{"data":1,"prerenderedAt":597},["ShallowReactive",2],{"content:\u002Funi-use\u002Fguide\u002Fnotice":3,"section:uni-use":7},{"id":4,"title":5,"aside":6,"authors":7,"badges":8,"banner":7,"body":17,"breadcrumb":6,"collapse":589,"description":7,"editLink":6,"extension":590,"fullpage":589,"header":7,"icon":591,"main":7,"meta":592,"navBadges":7,"navTruncate":589,"navigation":7,"path":593,"prevNext":6,"seo":594,"stem":595,"toc":6,"__hash__":596},"content\u002Funi-use\u002F1.guide\u002F2.notice.md","注意事项",true,null,[9,13],{"value":10,"to":11,"target":12},"npm","https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002F@uni-helper\u002Funi-use","_blank",{"value":14,"icon":15,"to":16,"target":12},"source","lucide:code","https:\u002F\u002Fgithub.com\u002Funi-helper\u002Funi-use",{"type":18,"value":19,"toc":584},"minimark",[20,24,28,57,68,71,100,115,354,381,538,554,558,580],[21,22,23],"h2",{"id":23},"限制",[25,26,27],"p",{},"在小程序和移动应用环境下有如下无法避开的限制：",[29,30,31,44,51],"ul",{},[32,33,34,35,39,40,43],"li",{},"缺失某些全局变量（如 ",[36,37,38],"code",{},"window","、",[36,41,42],{},"navigator"," 等）",[32,45,46,47,50],{},"必须使用 ",[36,48,49],{},"uni-app"," 提供的 API 实现功能（如拦截器、存储等），API 不支持的也就无法支持，比如拦截同步 API、监听其它地方引起的剪切板变化等",[32,52,53,54],{},"无法使用顶层 ",[36,55,56],{},"await",[25,58,59,60,63,64,67],{},"在开发网页时，建议直接使用 ",[36,61,62],{},"vue","，避免过多的环境判断代码，同时也能享受更好的生态，如 ",[36,65,66],{},"vueuse"," 的完整支持。",[21,69,70],{"id":70},"构建",[25,72,73,74,77,78,81,82,85,86,89,90,93,94,96,97,99],{},"目前 ",[36,75,76],{},"@uni-helper\u002Funi-use"," 会使用 ",[36,79,80],{},"unbuild"," 将 ",[36,83,84],{},"uni"," API 之外的部分转译到 ",[36,87,88],{},"ES2017","（即 ",[36,91,92],{},"ES8","）。",[36,95,84],{}," API 需要在项目构建时由 ",[36,98,49],{}," 官方提供的插件处理。",[25,101,102,103,106,107,110,111,114],{},"对于 ",[36,104,105],{},"vite + vue3"," 项目，请先设置 ",[36,108,109],{},"build.target"," 为 ",[36,112,113],{},"ES6","。",[116,117,123],"pre",{"className":118,"code":119,"filename":120,"language":121,"meta":122,"style":122},"language-typescript shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","import uni from '@dcloudio\u002Fvite-plugin-uni'\nimport { defineConfig } from 'vite'\n\n\u002F\u002F https:\u002F\u002Fvitejs.dev\u002Fconfig\u002F\nexport default defineConfig({\n  build: {\n    target: 'es6',\n    cssTarget: 'chrome61', \u002F\u002F https:\u002F\u002Fcn.vitejs.dev\u002Fconfig\u002Fbuild-options.html#build-csstarget\n  },\n  optimizeDeps: {\n    exclude: ['vue-demi'],\n  },\n  plugins: [\n    \u002F\u002F ...,\n    uni(),\n    \u002F\u002F ...,\n  ],\n})\n","vite.config.ts","typescript","",[36,124,125,152,176,182,189,207,220,239,260,266,276,299,304,315,321,332,337,345],{"__ignoreMap":122},[126,127,130,134,138,141,145,149],"span",{"class":128,"line":129},"line",1,[126,131,133],{"class":132},"s7zQu","import",[126,135,137],{"class":136},"sTEyZ"," uni ",[126,139,140],{"class":132},"from",[126,142,144],{"class":143},"sMK4o"," '",[126,146,148],{"class":147},"sfazB","@dcloudio\u002Fvite-plugin-uni",[126,150,151],{"class":143},"'\n",[126,153,155,157,160,163,166,169,171,174],{"class":128,"line":154},2,[126,156,133],{"class":132},[126,158,159],{"class":143}," {",[126,161,162],{"class":136}," defineConfig",[126,164,165],{"class":143}," }",[126,167,168],{"class":132}," from",[126,170,144],{"class":143},[126,172,173],{"class":147},"vite",[126,175,151],{"class":143},[126,177,179],{"class":128,"line":178},3,[126,180,181],{"emptyLinePlaceholder":6},"\n",[126,183,185],{"class":128,"line":184},4,[126,186,188],{"class":187},"sHwdD","\u002F\u002F https:\u002F\u002Fvitejs.dev\u002Fconfig\u002F\n",[126,190,192,195,198,201,204],{"class":128,"line":191},5,[126,193,194],{"class":132},"export",[126,196,197],{"class":132}," default",[126,199,162],{"class":200},"s2Zo4",[126,202,203],{"class":136},"(",[126,205,206],{"class":143},"{\n",[126,208,210,214,217],{"class":128,"line":209},6,[126,211,213],{"class":212},"swJcz","  build",[126,215,216],{"class":143},":",[126,218,219],{"class":143}," {\n",[126,221,223,226,228,230,233,236],{"class":128,"line":222},7,[126,224,225],{"class":212},"    target",[126,227,216],{"class":143},[126,229,144],{"class":143},[126,231,232],{"class":147},"es6",[126,234,235],{"class":143},"'",[126,237,238],{"class":143},",\n",[126,240,242,245,247,249,252,254,257],{"class":128,"line":241},8,[126,243,244],{"class":212},"    cssTarget",[126,246,216],{"class":143},[126,248,144],{"class":143},[126,250,251],{"class":147},"chrome61",[126,253,235],{"class":143},[126,255,256],{"class":143},",",[126,258,259],{"class":187}," \u002F\u002F https:\u002F\u002Fcn.vitejs.dev\u002Fconfig\u002Fbuild-options.html#build-csstarget\n",[126,261,263],{"class":128,"line":262},9,[126,264,265],{"class":143},"  },\n",[126,267,269,272,274],{"class":128,"line":268},10,[126,270,271],{"class":212},"  optimizeDeps",[126,273,216],{"class":143},[126,275,219],{"class":143},[126,277,279,282,284,287,289,292,294,297],{"class":128,"line":278},11,[126,280,281],{"class":212},"    exclude",[126,283,216],{"class":143},[126,285,286],{"class":136}," [",[126,288,235],{"class":143},[126,290,291],{"class":147},"vue-demi",[126,293,235],{"class":143},[126,295,296],{"class":136},"]",[126,298,238],{"class":143},[126,300,302],{"class":128,"line":301},12,[126,303,265],{"class":143},[126,305,307,310,312],{"class":128,"line":306},13,[126,308,309],{"class":212},"  plugins",[126,311,216],{"class":143},[126,313,314],{"class":136}," [\n",[126,316,318],{"class":128,"line":317},14,[126,319,320],{"class":187},"    \u002F\u002F ...,\n",[126,322,324,327,330],{"class":128,"line":323},15,[126,325,326],{"class":200},"    uni",[126,328,329],{"class":136},"()",[126,331,238],{"class":143},[126,333,335],{"class":128,"line":334},16,[126,336,320],{"class":187},[126,338,340,343],{"class":128,"line":339},17,[126,341,342],{"class":136},"  ]",[126,344,238],{"class":143},[126,346,348,351],{"class":128,"line":347},18,[126,349,350],{"class":143},"}",[126,352,353],{"class":136},")\n",[25,355,356,357,360,361,364,365,372,373,375,376,114],{},"然后在 ",[36,358,359],{},"src\u002Fmain.ts"," 或 ",[36,362,363],{},"src\u002Fmain.js"," 处自行添加 polyfill。以下是使用 ",[366,367,371],"a",{"href":368,"rel":369},"https:\u002F\u002Fgithub.com\u002Fzloirock\u002Fcore-js",[370],"nofollow","core-js"," 的示例（需要自行安装 ",[36,374,371],{},"），你也可以使用 ",[366,377,380],{"href":378,"rel":379},"https:\u002F\u002Fgithub.com\u002Fes-shims",[370],"es-shims",[116,382,384],{"className":118,"code":383,"filename":359,"language":121,"meta":122,"style":122},"\u002F\u002F 你可以根据需要自行添加额外的 polyfills\n\u002F\u002F import 'core-js\u002Factual\u002Fobject\u002Fvalues'\nimport { createSSRApp } from 'vue'\nimport App from '.\u002FApp.vue'\nimport 'core-js\u002Factual\u002Farray\u002Fiterator'\nimport 'core-js\u002Factual\u002Fpromise'\nimport 'core-js\u002Factual\u002Fobject\u002Fassign'\nimport 'core-js\u002Factual\u002Fpromise\u002Ffinally'\n\nexport function createApp() {\n  const app = createSSRApp(App)\n  return {\n    app,\n  }\n}\n",[36,385,386,391,396,415,431,442,453,464,475,479,494,514,521,528,533],{"__ignoreMap":122},[126,387,388],{"class":128,"line":129},[126,389,390],{"class":187},"\u002F\u002F 你可以根据需要自行添加额外的 polyfills\n",[126,392,393],{"class":128,"line":154},[126,394,395],{"class":187},"\u002F\u002F import 'core-js\u002Factual\u002Fobject\u002Fvalues'\n",[126,397,398,400,402,405,407,409,411,413],{"class":128,"line":178},[126,399,133],{"class":132},[126,401,159],{"class":143},[126,403,404],{"class":136}," createSSRApp",[126,406,165],{"class":143},[126,408,168],{"class":132},[126,410,144],{"class":143},[126,412,62],{"class":147},[126,414,151],{"class":143},[126,416,417,419,422,424,426,429],{"class":128,"line":184},[126,418,133],{"class":132},[126,420,421],{"class":136}," App ",[126,423,140],{"class":132},[126,425,144],{"class":143},[126,427,428],{"class":147},".\u002FApp.vue",[126,430,151],{"class":143},[126,432,433,435,437,440],{"class":128,"line":191},[126,434,133],{"class":132},[126,436,144],{"class":143},[126,438,439],{"class":147},"core-js\u002Factual\u002Farray\u002Fiterator",[126,441,151],{"class":143},[126,443,444,446,448,451],{"class":128,"line":209},[126,445,133],{"class":132},[126,447,144],{"class":143},[126,449,450],{"class":147},"core-js\u002Factual\u002Fpromise",[126,452,151],{"class":143},[126,454,455,457,459,462],{"class":128,"line":222},[126,456,133],{"class":132},[126,458,144],{"class":143},[126,460,461],{"class":147},"core-js\u002Factual\u002Fobject\u002Fassign",[126,463,151],{"class":143},[126,465,466,468,470,473],{"class":128,"line":241},[126,467,133],{"class":132},[126,469,144],{"class":143},[126,471,472],{"class":147},"core-js\u002Factual\u002Fpromise\u002Ffinally",[126,474,151],{"class":143},[126,476,477],{"class":128,"line":262},[126,478,181],{"emptyLinePlaceholder":6},[126,480,481,483,487,490,492],{"class":128,"line":268},[126,482,194],{"class":132},[126,484,486],{"class":485},"spNyl"," function",[126,488,489],{"class":200}," createApp",[126,491,329],{"class":143},[126,493,219],{"class":143},[126,495,496,499,502,505,507,509,512],{"class":128,"line":278},[126,497,498],{"class":485},"  const",[126,500,501],{"class":136}," app",[126,503,504],{"class":143}," =",[126,506,404],{"class":200},[126,508,203],{"class":212},[126,510,511],{"class":136},"App",[126,513,353],{"class":212},[126,515,516,519],{"class":128,"line":301},[126,517,518],{"class":132},"  return",[126,520,219],{"class":143},[126,522,523,526],{"class":128,"line":306},[126,524,525],{"class":136},"    app",[126,527,238],{"class":143},[126,529,530],{"class":128,"line":317},[126,531,532],{"class":143},"  }\n",[126,534,535],{"class":128,"line":323},[126,536,537],{"class":143},"}\n",[25,539,540,541,546,547,550,551,114],{},"微信小程序的 JavaScript 支持度见 ",[366,542,545],{"href":543,"rel":544},"https:\u002F\u002Fgithub.com\u002Fwechat-miniprogram\u002Fminiprogram-compat",[370],"wechat-miniprogram\u002Fminiprogram-compat","。微信小程序要支持 ",[36,548,549],{},"vue3","，需设置基础库最低版本为 2.11.2 或以上，2.11.2 对应 ",[36,552,553],{},"chrome>=53,ios>=10",[21,555,557],{"id":556},"eventbus","EventBus",[25,559,560,561,563,564,39,569,360,574,579],{},"如果你想使用 ",[36,562,557],{},"，请考虑使用 ",[366,565,568],{"href":566,"rel":567},"https:\u002F\u002Fvueuse.org\u002Fcore\u002Fuseeventbus\u002F#useeventbus",[370],"VueUse - useEventBus",[366,570,573],{"href":571,"rel":572},"https:\u002F\u002Fgithub.com\u002Fdevelopit\u002Fmitt",[370],"mitt",[366,575,578],{"href":576,"rel":577},"https:\u002F\u002Fgithub.com\u002Fai\u002Fnanoevents",[370],"nanoevents","。这个库不再重复提供类似功能。",[581,582,583],"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 .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}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 .s2Zo4, html code.shiki .s2Zo4{--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF}html pre.shiki code .swJcz, html code.shiki .swJcz{--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178}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}",{"title":122,"searchDepth":154,"depth":154,"links":585},[586,587,588],{"id":23,"depth":154,"text":23},{"id":70,"depth":154,"text":70},{"id":556,"depth":154,"text":557},false,"md","lucide:info",{},"\u002Funi-use\u002Fguide\u002Fnotice",{"title":5,"description":7},"uni-use\u002F1.guide\u002F2.notice","knLlHQjO9OGwF-sUvDwEHfu8_lwNfuszkLeDxEudPd0",1795165271006]