\r\n```\n\n### Expected behavior\n\nsuccessfully \n\n### System Info\n\n```shell\nSystem:\r\n OS: Windows 10 10.0.22000\r\n CPU: (6) x64 Intel(R) Core(TM) i5-8400 CPU @ 2.80GHz\r\n Memory: 6.54 GB / 15.88 GB\r\n Binaries:\r\n Node: 16.13.0 - C:\\nodejs\\node.EXE\r\n npm: 8.1.4 - C:\\nodejs\\npm.CMD\r\n Browsers:\r\n Edge: Spartan (44.22000.120.0), Chromium (98.0.1108.50)\r\n Internet Explorer: 11.0.22000.120\r\n npmPackages:\r\n vitepress: ^0.22.2 => 0.22.2\n```\n\n\n### Additional context\n\n_No response_\n\n### Validations\n\n- [X] Follow our [Code of Conduct](https://vuejs.org/coc)\n- [X] Read the [docs](https://vitepress.vuejs.org/).\n- [X] Check that there isn't already an issue that reports the same bug to avoid creating a duplicate.",[3189],{"name":3152,"color":3153},539,"build error:Blob is not defined","2023-01-21T16:20:11Z","https://github.com/vuejs/vitepress/issues/539",0.6771124,{"description":3196,"labels":3197,"number":3201,"owner":3155,"repository":3156,"state":3157,"title":3202,"updated_at":3203,"url":3204,"score":3205},"build error:\nrender is not a function\nTypeError: render is not a function\n at renderPage (file:///D:/0.Project/Note/node_modules/vitepress/dist/node/chunk-D3CUZ4fa.js:49377:25)\n at pMap.concurrency (file:///D:/0.Project/Note/node_modules/vitepress/dist/node/chunk-D3CUZ4fa.js:49624:17)\n at file:///D:/0.Project/Note/node_modules/vitepress/dist/node/chunk-D3CUZ4fa.js:4505:26\n\n但是我把自定义组件注释掉还是存在报错",[3198],{"name":3199,"color":3200},"need more info","bdbefc",4900,"Vitepress 的渲染失败render is not a function","2025-08-13T07:40:33Z","https://github.com/vuejs/vitepress/issues/4900",0.6776331,{"description":3207,"labels":3208,"number":3210,"owner":3155,"repository":3156,"state":3157,"title":3211,"updated_at":3212,"url":3213,"score":3214},"### Describe the bug\n\nI imported a lib which called document APIs. The minimized reproduction:\r\n\r\n```\r\n\u003Cscript>\r\nconst div = document.createElement('div');\r\nconsole.log(div)\r\n\u003C/script>\r\n\r\n# Hello World\r\n```\r\n\r\nIt works in vitepress dev but fails in vitepress build\n\n### Reproduction\n\nhttps://github.com/Jinjiang/reproductions/tree/vitepress-document-20240219\n\n### Expected behavior\n\nWorks as vitepress dev does\n\n### System Info\n\n```Text\n$ npx envinfo --system --npmPackages vitepress --binaries --browsers\r\n\r\n System:\r\n OS: macOS 14.4\r\n CPU: (8) arm64 Apple M1\r\n Memory: 75.17 MB / 8.00 GB\r\n Shell: 5.9 - /bin/zsh\r\n Binaries:\r\n Node: 20.1.0 - ~/.asdf/installs/nodejs/20.1.0/bin/node\r\n Yarn: 1.22.19 - ~/.asdf/shims/yarn\r\n npm: 9.6.4 - ~/.asdf/plugins/nodejs/shims/npm\r\n Browsers:\r\n Safari: 17.4\r\n npmPackages:\r\n vitepress: 1.0.0-rc.43 => 1.0.0-rc.43\n```\n\n\n### Additional context\n\n_No response_\n\n### Validations\n\n- [X] Check if you're on the [latest VitePress version](https://github.com/vuejs/vitepress/releases/latest).\n- [X] Follow our [Code of Conduct](https://vuejs.org/about/coc.html)\n- [X] Read the [docs](https://vitepress.dev).\n- [X] Check that there isn't already an issue that reports the same bug to avoid creating a duplicate.",[3209],{"name":3152,"color":3153},3583,"document is not defined when vitepress build","2024-02-27T00:05:55Z","https://github.com/vuejs/vitepress/issues/3583",0.68028754,{"description":3216,"labels":3217,"number":3219,"owner":3155,"repository":3156,"state":3157,"title":3158,"updated_at":3220,"url":3221,"score":3222},"### Describe the bug\n\nI am writing the package of `controllable-animate` and preparing write doc for this package \r\n\r\nwhen I run npm run docs:dev it works just fine\r\nbut when I run npm run docs:build it failed\r\nand shows an error message:\r\n```sh\r\n✓ building client + server bundles...\r\nbuild error:\r\n ReferenceError: document is not defined\r\n at file:///Users/songwufan/Desktop/newPro/controllable-animate/docs/main/.vitepress/.temp/app.js:4380:3\r\n at ModuleJob.run (internal/modules/esm/module_job.js:183:25)\r\n at async Loader.import (internal/modules/esm/loader.js:178:24)\r\n at async build (file:///Users/songwufan/Desktop/newPro/controllable-animate/node_modules/.pnpm/vitepress@1.0.0-alpha.29_tbpndr44ulefs3hehwpi2mkf2y/node_modules/vitepress/dist/node/serve-fcdc8868.js:42002:24)\r\n```\r\nreproduce steps: \r\nFirst: I try to use `docuement` in vue directive like this: \r\n```ts\r\nif (typeof window !== undefined) {\r\n root = document.documentElement || document.body\r\n}\r\n```\r\nSecond: I use this package in my code :main/.vitepress/theme/index.ts\r\n```ts\r\nimport {\r\n vcontrollableanimate,\r\n} from 'controllable-animate'\r\nexport default {\r\n ...DefaultTheme,\r\n enhanceApp({ app }) {\r\n // app.Plugin\r\n app.directive('controllable-animate', vcontrollableanimate)\r\n },\r\n}\r\n```\n\n### Reproduction\n\nnone\n\n### Expected behavior\n\nIt should work in dev and build mode.\n\n### System Info\n\n```shell\nSystem:\r\n OS: macOS 12.6\r\n CPU: (4) x64 Intel(R) Core(TM) i5-7267U CPU @ 3.10GHz\r\n Memory: 103.34 MB / 8.00 GB\r\n Shell: 5.8.1 - /bin/zsh\r\n Binaries:\r\n Node: 14.19.0 - ~/.nvm/versions/node/v14.19.0/bin/node\r\n Yarn: 1.22.17 - /usr/local/bin/yarn\r\n npm: 6.14.16 - ~/.nvm/versions/node/v14.19.0/bin/npm\r\n Watchman: 4.9.0 - /usr/local/bin/watchman\r\n Browsers:\r\n Chrome: 107.0.5304.110\r\n Chrome Canary: 110.0.5434.0\r\n Firefox: 97.0.2\r\n Firefox Developer Edition: 106.0\r\n Safari: 15.6.1\r\n npmPackages:\r\n vitepress: 1.0.0-alpha.29 => 1.0.0-alpha.29\n```\n\n\n### Additional context\n\n_No response_\n\n### Validations\n\n- [X] Follow our [Code of Conduct](https://vuejs.org/about/coc.html)\n- [X] Read the [docs](https://vitepress.vuejs.org).\n- [X] Check that there isn't already an issue that reports the same bug to avoid creating a duplicate.",[3218],{"name":3152,"color":3153},1638,"2023-01-21T14:20:37Z","https://github.com/vuejs/vitepress/issues/1638",0.6830792,{"description":3224,"labels":3225,"number":3226,"owner":3155,"repository":3156,"state":3157,"title":3227,"updated_at":3228,"url":3229,"score":3230},"Minimal Reproducible Example: https://stackblitz.com/edit/vite-qjxpzz?file=docs%2FHelloWorld.vue (run `vitepress build docs`)\r\n\r\n---\r\n\r\n### Describe the bug\r\n\r\nI just had a live Vitepress site hosted on Netlify, using Vitepress 0.20.4 (EDIT: it's now at 1.0.0 alpha 4), fail a build with only content having changed. The site is publicly available on Github for reproduction: https://github.com/Ragura/dinkcreference.\r\n\r\nUsing `pnpm docs:build` command I get:\r\n\r\n```\r\n✓ building client + server bundles...\r\n✖ rendering pages...\r\nbuild error:\r\n ReferenceError: _unref is not defined\r\n at /Users/me/development/dinkcreference/node_modules/.pnpm/vitepress@0.20.4/node_modules/vitepress/dist/client/app/temp/app.js:1646:23\r\n at renderComponentSubTree (/Users/me/development/dinkcreference/node_modules/.pnpm/@vue+server-renderer@3.2.37_vue@3.2.37/node_modules/@vue/server-renderer/dist/server-renderer.cjs.prod.js:250:13)\r\n at renderComponentVNode (/Users/me/development/dinkcreference/node_modules/.pnpm/@vue+server-renderer@3.2.37_vue@3.2.37/node_modules/@vue/server-renderer/dist/server-renderer.cjs.prod.js:185:16)\r\n at Object.ssrRenderComponent (/Users/me/development/dinkcreference/node_modules/.pnpm/@vue+server-renderer@3.2.37_vue@3.2.37/node_modules/@vue/server-renderer/dist/server-renderer.cjs.prod.js:605:12)\r\n at _sfc_ssrRender (/Users/me/development/dinkcreference/node_modules/.pnpm/vitepress@0.20.4/node_modules/vitepress/dist/client/app/temp/functions_set-font-color.md.js:25:24)\r\n at renderComponentSubTree (/Users/me/development/dinkcreference/node_modules/.pnpm/@vue+server-renderer@3.2.37_vue@3.2.37/node_modules/@vue/server-renderer/dist/server-renderer.cjs.prod.js:250:13)\r\n at renderComponentVNode (/Users/me/development/dinkcreference/node_modules/.pnpm/@vue+server-renderer@3.2.37_vue@3.2.37/node_modules/@vue/server-renderer/dist/server-renderer.cjs.prod.js:185:16)\r\n at renderVNode (/Users/me/development/dinkcreference/node_modules/.pnpm/@vue+server-renderer@3.2.37_vue@3.2.37/node_modules/@vue/server-renderer/dist/server-renderer.cjs.prod.js:292:22)\r\n at renderVNodeChildren (/Users/me/development/dinkcreference/node_modules/.pnpm/@vue+server-renderer@3.2.37_vue@3.2.37/node_modules/@vue/server-renderer/dist/server-renderer.cjs.prod.js:307:9)\r\n at renderElementVNode (/Users/me/development/dinkcreference/node_modules/.pnpm/@vue+server-renderer@3.2.37_vue@3.2.37/node_modules/@vue/server-renderer/dist/server-renderer.cjs.prod.js:358:17)\r\n```\r\nIt is not using any outside packages, just pure Vitepress with Docsearch enabled.\r\nIf I run dev/serve commands, it works just fine locally. Only when building does it fail. Any idea what could be causing this?\r\n\r\n### Reproduction\r\n\r\nClone https://github.com/Ragura/dinkcreference.\r\nRun `pnpm docs:build`\r\n\r\n### Expected behavior\r\n\r\nIt should build, but fails.\r\n\r\n### System Info\r\n\r\n```shell\r\nSystem:\r\n OS: macOS 12.3\r\n CPU: (10) arm64 Apple M1 Pro\r\n Memory: 86.88 MB / 16.00 GB\r\n Shell: 5.8 - /bin/zsh\r\n Binaries:\r\n Node: 17.0.1 - ~/.nvm/versions/node/v17.0.1/bin/node\r\n npm: 8.13.1 - ~/.nvm/versions/node/v17.0.1/bin/npm\r\n Browsers:\r\n Chrome: 103.0.5060.53\r\n Safari: 15.4\r\n```\r\n\r\n\r\n### Additional context\r\n\r\n_No response_\r\n\r\n### Validations\r\n\r\n- [X] Follow our [Code of Conduct](https://vuejs.org/about/coc.html)\r\n- [X] Read the [docs](https://vitepress.vuejs.org).\r\n- [X] Check that there isn't already an issue that reports the same bug to avoid creating a duplicate.",[],876,"v-bind not working with computed properties","2023-01-21T14:32:41Z","https://github.com/vuejs/vitepress/issues/876",0.68391126,{"description":3232,"labels":3233,"number":3235,"owner":3155,"repository":3156,"state":3157,"title":3236,"updated_at":3237,"url":3238,"score":3239},"### Describe the bug\n\nI've implemented a vitepress site for a component library used internally. Running `npm run docs:dev` works as intended and the documentation site is functional. When I attempt to build the docs site, I get an ambiguous error that has no line references other than line references to a temp file that is deleted by the same process, so I have no way to diagnose what this error is. I'm sure it's a simple fix, but without saving that temp file or finding a better stack trace, I don't feel like I have direction to find where to start.\r\n\r\n```bash\r\n❯ npm run docs:build \r\n\r\n> @rtidatascience/harness-vue-bootstrap@1.0.0 docs:build\r\n> vitepress build docs\r\n\r\nvitepress v1.0.0-alpha.17\r\n⠋ building client + server bundles...\"compileScript\" is imported from external module \"vue/compiler-sfc\" but never used in \"docs/.vitepress/harness-pages/examplePage.js\".\r\n⠼ building client + server bundles...\r\n(!) Some chunks are larger than 500 KiB after minification. Consider:\r\n- Using dynamic import() to code-split the application\r\n- Use build.rollupOptions.output.manualChunks to improve chunking: https://rollupjs.org/guide/en/#outputmanualchunks\r\n- Adjust chunk size limit for this warning via build.chunkSizeWarningLimit.\r\n✓ building client + server bundles...\r\n✖ rendering pages...\r\nbuild error:\r\n TypeError: Cannot read properties of undefined (reading 'filter')\r\n at _sfc_ssrRender$1 (file:///Users/alexharding/Projects/harness-vue-starter-template/dev-packages/harness-vue-bootstrap/docs/.vitepress/.temp/app.js:5710:164)\r\n at renderComponentSubTree (/Users/alexharding/Projects/harness-vue-starter-template/dev-packages/harness-vue-bootstrap/node_modules/@vue/server-renderer/dist/server-renderer.cjs.prod.js:251:17)\r\n at renderComponentVNode (/Users/alexharding/Projects/harness-vue-starter-template/dev-packages/harness-vue-bootstrap/node_modules/@vue/server-renderer/dist/server-renderer.cjs.prod.js:185:16)\r\n at ssrRenderComponent (/Users/alexharding/Projects/harness-vue-starter-template/dev-packages/harness-vue-bootstrap/node_modules/@vue/server-renderer/dist/server-renderer.cjs.prod.js:609:12)\r\n at _sfc_ssrRender (file:///Users/alexharding/Projects/harness-vue-starter-template/dev-packages/harness-vue-bootstrap/docs/.vitepress/.temp/components_filters_multiselectListbox.md.js:9:9)\r\n at renderComponentSubTree (/Users/alexharding/Projects/harness-vue-starter-template/dev-packages/harness-vue-bootstrap/node_modules/@vue/server-renderer/dist/server-renderer.cjs.prod.js:251:17)\r\n at renderComponentVNode (/Users/alexharding/Projects/harness-vue-starter-template/dev-packages/harness-vue-bootstrap/node_modules/@vue/server-renderer/dist/server-renderer.cjs.prod.js:185:16)\r\n at renderVNode (/Users/alexharding/Projects/harness-vue-starter-template/dev-packages/harness-vue-bootstrap/node_modules/@vue/server-renderer/dist/server-renderer.cjs.prod.js:296:22)\r\n at renderVNodeChildren (/Users/alexharding/Projects/harness-vue-starter-template/dev-packages/harness-vue-bootstrap/node_modules/@vue/server-renderer/dist/server-renderer.cjs.prod.js:311:9)\r\n at renderElementVNode (/Users/alexharding/Projects/harness-vue-starter-template/dev-packages/harness-vue-bootstrap/node_modules/@vue/server-renderer/dist/server-renderer.cjs.prod.js:362:17)\r\n```\n\n### Reproduction\n\nClone the repository [harness-vue-bootstrap](https://github.com/RTIInternational/harness-vue-bootstrap)\r\n`npm install`\r\n`npm run docs:build`\n\n### Expected behavior\n\nAn option to save temporary files on failed build.\n\n### System Info\n\n```shell\nSystem:\r\n OS: macOS 12.5.1\r\n CPU: (10) arm64 Apple M1 Pro\r\n Memory: 353.69 MB / 16.00 GB\r\n Shell: 5.8.1 - /bin/zsh\r\n Binaries:\r\n Node: 16.15.1 - /usr/local/bin/node\r\n Yarn: 1.22.19 - /usr/local/bin/yarn\r\n npm: 8.11.0 - /usr/local/bin/npm\r\n Browsers:\r\n Chrome: 105.0.5195.125\r\n Firefox: 105.0.1\r\n Safari: 15.6.1\r\n```\n```\n\n\n### Additional context\n\n_No response_\n\n### Validations\n\n- [X] Follow our [Code of Conduct](https://vuejs.org/about/coc.html)\n- [X] Read the [docs](https://vitepress.vuejs.org).\n- [X] Check that there isn't already an issue that reports the same bug to avoid creating a duplicate.",[3234],{"name":3152,"color":3153},1424,"Ambiguous error in build process/temp files deleted on failed build","2023-01-21T14:25:17Z","https://github.com/vuejs/vitepress/issues/1424",0.68457055,["Reactive",3241],{},["Set"],["ShallowReactive",3244],{"$fTRc1wZytZ_XrK4EfJfei_Sz-An4H4Yy6syhVxH_PVJc":-1,"$ftC6GwOsiTSyNO49aP9Ud6FW5h4Hd4NECyNydE_xTknY":-1},"/vuejs/vitepress/21"]