[{"data":1,"prerenderedAt":464},["ShallowReactive",2],{"navigation_docs":3,"diagnostic-content-NUXT0085":48},[4,8,12,16,20,24,28,32,36,40,44],{"title":5,"path":6,"stem":7},"CLI","\u002Fcli","1.cli",{"title":9,"path":10,"stem":11},"Nuxt","\u002Fnuxt","2.nuxt",{"title":13,"path":14,"stem":15},"Vue","\u002Fvue","3.vue",{"title":17,"path":18,"stem":19},"Vite","\u002Fvite","4.vite",{"title":21,"path":22,"stem":23},"Nitro","\u002Fnitro","5.nitro",{"title":25,"path":26,"stem":27},"TypeScript","\u002Ftypescript","6.typescript",{"title":29,"path":30,"stem":31},"shadcn","\u002Fshadcn","7.shadcn",{"title":33,"path":34,"stem":35},"Package","\u002Fpackage","8.package",{"title":37,"path":38,"stem":39},"Extending Doctor","\u002Fextending","9.extending",{"title":41,"path":42,"stem":43},"MCP","\u002Fmcp","9.mcp",{"title":45,"path":46,"stem":47},"Pinia","\u002Fpinia","9.pinia",{"id":49,"title":50,"body":51,"category":57,"code":454,"description":455,"docsUrl":58,"extension":456,"fix":457,"framework":458,"meta":459,"navigation":221,"pack":60,"path":460,"ruleId":61,"rulePath":62,"seo":461,"severity":63,"source":64,"sourceUrl":65,"stem":462,"why":74,"__hash__":463},"diagnostics\u002Fdiagnostics\u002FNUXT0085.md","NUXT0085: Initialize VueUse browser storage on mount in SSR apps",{"type":52,"value":53,"toc":444},"minimark",[54,66,71,75,79,109,113,118,121,262,265,380,384,387,412,416,428,432,440],[55,56],"rule-metadata",{"category":57,"docsUrl":58,"fix":59,"pack":60,"ruleId":61,"rulePath":62,"severity":63,"source":64,"sourceUrl":65},"hydration","https:\u002F\u002Fvueuse.org\u002Fcore\u002FuseStorage\u002F#initonmounted","suggestion","vite-doctor\u002Fnuxt","vueuse\u002Fssr\u002Frequire-init-on-mounted-storage","\u002Fnuxt\u002Frules\u002Fssr\u002Frequire-init-on-mounted-storage","warn","src\u002Frule-packs\u002Fnuxt\u002Frules\u002Fvueuse-storage.ts","https:\u002F\u002Fgithub.com\u002Fonmax\u002Fvite-doctor\u002Fblob\u002Fmain\u002Fsrc\u002Frule-packs\u002Fnuxt\u002Frules\u002Fvueuse-storage.ts",[67,68,70],"h2",{"id":69},"why-it-happens","Why it happens",[72,73,74],"p",{},"VueUse reads browser storage synchronously when the composable runs. The server has no browser storage and renders the default value, so a stored value changes the first client render and Vue reports a hydration mismatch. Guarding the call with import.meta.client does not help, because the client branch still runs during hydration.",[67,76,78],{"id":77},"fix","Fix",[72,80,81,82,86,87,90,91,94,95,98,99,102,103,105,106,108],{},"Pass { initOnMounted: true } so VueUse reads storage after the component mounts, or use ",[83,84,85],"code",{},"useCookie()"," for state the server must render. A ",[83,88,89],{},"useStorage()"," call that passes localStorage or sessionStorage explicitly throws on the server before initOnMounted can help, so use ",[83,92,93],{},"useLocalStorage()"," or ",[83,96,97],{},"useSessionStorage()"," with { initOnMounted: true } instead. Doctor skips .client files, calls inside ",[83,100,101],{},"onMounted()",", apps with ssr: false, and refs that are only read in event handlers, watch callbacks, lifecycle hooks or unrendered computed values. With @vueuse\u002Fnuxt's ssrHandlers option, ",[83,104,89],{}," without a storage argument uses cookies; Doctor cannot see that option, so it only reports ",[83,107,89],{}," without a storage argument in apps without @vueuse\u002Fnuxt.",[67,110,112],{"id":111},"example","Example",[114,115,117],"h3",{"id":116},"read-stored-preferences-after-mount","Read stored preferences after mount",[72,119,120],{},"Before",[122,123,128],"pre",{"className":124,"code":125,"language":126,"meta":127,"style":127},"language-vue shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","\u003Cscript setup lang=\"ts\">\nconst granularity = useSessionStorage('plan-granularity', 'month')\n\u003C\u002Fscript>\n\n\u003Ctemplate>\n  \u003Cspan>{{ granularity }}\u003C\u002Fspan>\n\u003C\u002Ftemplate>\n","vue","",[83,129,130,165,206,216,223,233,253],{"__ignoreMap":127},[131,132,135,139,143,147,150,153,156,160,162],"span",{"class":133,"line":134},"line",1,[131,136,138],{"class":137},"sMK4o","\u003C",[131,140,142],{"class":141},"swJcz","script",[131,144,146],{"class":145},"spNyl"," setup",[131,148,149],{"class":145}," lang",[131,151,152],{"class":137},"=",[131,154,155],{"class":137},"\"",[131,157,159],{"class":158},"sfazB","ts",[131,161,155],{"class":137},[131,163,164],{"class":137},">\n",[131,166,168,171,175,177,181,184,187,190,192,195,198,201,203],{"class":133,"line":167},2,[131,169,170],{"class":145},"const",[131,172,174],{"class":173},"sTEyZ"," granularity ",[131,176,152],{"class":137},[131,178,180],{"class":179},"s2Zo4"," useSessionStorage",[131,182,183],{"class":173},"(",[131,185,186],{"class":137},"'",[131,188,189],{"class":158},"plan-granularity",[131,191,186],{"class":137},[131,193,194],{"class":137},",",[131,196,197],{"class":137}," '",[131,199,200],{"class":158},"month",[131,202,186],{"class":137},[131,204,205],{"class":173},")\n",[131,207,209,212,214],{"class":133,"line":208},3,[131,210,211],{"class":137},"\u003C\u002F",[131,213,142],{"class":141},[131,215,164],{"class":137},[131,217,219],{"class":133,"line":218},4,[131,220,222],{"emptyLinePlaceholder":221},true,"\n",[131,224,226,228,231],{"class":133,"line":225},5,[131,227,138],{"class":137},[131,229,230],{"class":141},"template",[131,232,164],{"class":137},[131,234,236,239,241,244,247,249,251],{"class":133,"line":235},6,[131,237,238],{"class":137},"  \u003C",[131,240,131],{"class":141},[131,242,243],{"class":137},">",[131,245,246],{"class":173},"{{ granularity }}",[131,248,211],{"class":137},[131,250,131],{"class":141},[131,252,164],{"class":137},[131,254,256,258,260],{"class":133,"line":255},7,[131,257,211],{"class":137},[131,259,230],{"class":141},[131,261,164],{"class":137},[72,263,264],{},"After",[122,266,268],{"className":124,"code":267,"language":126,"meta":127,"style":127},"\u003Cscript setup lang=\"ts\">\nconst granularity = useSessionStorage('plan-granularity', 'month', { initOnMounted: true })\n\u003C\u002Fscript>\n\n\u003Ctemplate>\n  \u003Cspan>{{ granularity }}\u003C\u002Fspan>\n\u003C\u002Ftemplate>\n",[83,269,270,290,336,344,348,356,372],{"__ignoreMap":127},[131,271,272,274,276,278,280,282,284,286,288],{"class":133,"line":134},[131,273,138],{"class":137},[131,275,142],{"class":141},[131,277,146],{"class":145},[131,279,149],{"class":145},[131,281,152],{"class":137},[131,283,155],{"class":137},[131,285,159],{"class":158},[131,287,155],{"class":137},[131,289,164],{"class":137},[131,291,292,294,296,298,300,302,304,306,308,310,312,314,316,318,321,324,327,331,334],{"class":133,"line":167},[131,293,170],{"class":145},[131,295,174],{"class":173},[131,297,152],{"class":137},[131,299,180],{"class":179},[131,301,183],{"class":173},[131,303,186],{"class":137},[131,305,189],{"class":158},[131,307,186],{"class":137},[131,309,194],{"class":137},[131,311,197],{"class":137},[131,313,200],{"class":158},[131,315,186],{"class":137},[131,317,194],{"class":137},[131,319,320],{"class":137}," {",[131,322,323],{"class":141}," initOnMounted",[131,325,326],{"class":137},":",[131,328,330],{"class":329},"sfNiH"," true",[131,332,333],{"class":137}," }",[131,335,205],{"class":173},[131,337,338,340,342],{"class":133,"line":208},[131,339,211],{"class":137},[131,341,142],{"class":141},[131,343,164],{"class":137},[131,345,346],{"class":133,"line":218},[131,347,222],{"emptyLinePlaceholder":221},[131,349,350,352,354],{"class":133,"line":225},[131,351,138],{"class":137},[131,353,230],{"class":141},[131,355,164],{"class":137},[131,357,358,360,362,364,366,368,370],{"class":133,"line":235},[131,359,238],{"class":137},[131,361,131],{"class":141},[131,363,243],{"class":137},[131,365,246],{"class":173},[131,367,211],{"class":137},[131,369,131],{"class":141},[131,371,164],{"class":137},[131,373,374,376,378],{"class":133,"line":255},[131,375,211],{"class":137},[131,377,230],{"class":141},[131,379,164],{"class":137},[67,381,383],{"id":382},"verify-the-fix","Verify the fix",[72,385,386],{},"Run only this rule after editing so the report stays focused on the diagnostic you are closing:",[122,388,392],{"className":389,"code":390,"language":391,"meta":127,"style":127},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","pnpm nuxt doctor --rules vueuse\u002Fssr\u002Frequire-init-on-mounted-storage\n","bash",[83,393,394],{"__ignoreMap":127},[131,395,396,400,403,406,409],{"class":133,"line":134},[131,397,399],{"class":398},"sBMFI","pnpm",[131,401,402],{"class":158}," nuxt",[131,404,405],{"class":158}," doctor",[131,407,408],{"class":158}," --rules",[131,410,411],{"class":158}," vueuse\u002Fssr\u002Frequire-init-on-mounted-storage\n",[67,413,415],{"id":414},"useful-links","Useful links",[417,418,419],"ul",{},[420,421,422],"li",{},[423,424,427],"a",{"href":58,"rel":425},[426],"nofollow","Upstream docs",[67,429,431],{"id":430},"related-rule","Related rule",[417,433,434],{},[420,435,436],{},[423,437,438],{"href":62},[83,439,61],{},[441,442,443],"style",{},"html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .swJcz, html code.shiki .swJcz{--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178}html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}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 .sfNiH, html code.shiki .sfNiH{--shiki-light:#FF5370;--shiki-default:#FF9CAC;--shiki-dark:#FF9CAC}html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}",{"title":127,"searchDepth":167,"depth":167,"links":445},[446,447,448,451,452,453],{"id":69,"depth":167,"text":70},{"id":77,"depth":167,"text":78},{"id":111,"depth":167,"text":112,"children":449},[450],{"id":116,"depth":208,"text":117},{"id":382,"depth":167,"text":383},{"id":414,"depth":167,"text":415},{"id":430,"depth":167,"text":431},"NUXT0085","Finds VueUse useLocalStorage(), useSessionStorage() and browser-backed useStorage() calls in SSR Nuxt apps that read storage while the page hydrates.","md","Pass { initOnMounted: true } so VueUse reads storage after the component mounts, or use useCookie() for state the server must render. A useStorage() call that passes localStorage or sessionStorage explicitly throws on the server before initOnMounted can help, so use useLocalStorage() or useSessionStorage() with { initOnMounted: true } instead. Doctor skips .client files, calls inside onMounted(), apps with ssr: false, and refs that are only read in event handlers, watch callbacks, lifecycle hooks or unrendered computed values. With @vueuse\u002Fnuxt's ssrHandlers option, useStorage() without a storage argument uses cookies; Doctor cannot see that option, so it only reports useStorage() without a storage argument in apps without @vueuse\u002Fnuxt.","nuxt",{},"\u002Fdiagnostics\u002Fnuxt0085",{"title":50,"description":455},"diagnostics\u002FNUXT0085","f1hQ2clAMDxAoSDzYlefRaryCOzABqW6JZNgIk1SPu8",1795268827114]