[{"data":1,"prerenderedAt":387},["ShallowReactive",2],{"navigation_docs":3,"rule-content-\u002Fvue\u002Frules\u002Fssr\u002Fno-setup-state-from-browser-read":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,"description":375,"diagnosticCodes":376,"docsUrl":59,"extension":377,"fix":60,"framework":378,"meta":379,"navigation":380,"pack":61,"path":382,"recommendedReplacement":383,"ruleId":62,"seo":384,"severity":63,"source":64,"sourceUrl":65,"stem":385,"why":116,"__hash__":386},"rules\u002Fvue\u002Frules\u002Fssr\u002Fno-setup-state-from-browser-read.md","Do not initialize SSR-rendered state from a browser read in setup",{"type":52,"value":53,"toc":366},"minimark",[54,66,71,109,113,117,121,140,144,156,160,165,168,267,270,362],[55,56],"rule-metadata",{"category":57,"diagnosticCodes":58,"docsUrl":59,"fix":60,"pack":61,"ruleId":62,"severity":63,"source":64,"sourceUrl":65},"ssr","VUE0042","https:\u002F\u002Fvuejs.org\u002Fguide\u002Fscaling-up\u002Fssr.html#hydration-mismatch","suggestion","vite-doctor\u002Fvue","vue\u002Fssr\u002Fno-setup-state-from-browser-read","warn","src\u002Frule-packs\u002Fvue\u002Frules\u002Fvue\u002Fno-setup-state-from-browser-read.ts","https:\u002F\u002Fgithub.com\u002Fonmax\u002Fvite-doctor\u002Fblob\u002Fmain\u002Fsrc\u002Frule-packs\u002Fvue\u002Frules\u002Fvue\u002Fno-setup-state-from-browser-read.ts",[67,68,70],"h2",{"id":69},"run-this-rule","Run this rule",[72,73,78],"pre",{"className":74,"code":75,"language":76,"meta":77,"style":77},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","pnpm vite-doctor . --framework vue --rules vue\u002Fssr\u002Fno-setup-state-from-browser-read\n","bash","",[79,80,81],"code",{"__ignoreMap":77},[82,83,86,90,94,97,100,103,106],"span",{"class":84,"line":85},"line",1,[82,87,89],{"class":88},"sBMFI","pnpm",[82,91,93],{"class":92},"sfazB"," vite-doctor",[82,95,96],{"class":92}," .",[82,98,99],{"class":92}," --framework",[82,101,102],{"class":92}," vue",[82,104,105],{"class":92}," --rules",[82,107,108],{"class":92}," vue\u002Fssr\u002Fno-setup-state-from-browser-read\n",[67,110,112],{"id":111},"why-it-matters","Why it matters",[114,115,116],"p",{},"The server cannot read localStorage, navigator.onLine or the viewport, so it renders the fallback, while the first client render starts from the browser value. Vue then logs a hydration mismatch and patches or rebuilds the subtree. A typeof window or import.meta.client guard prevents the server crash but is exactly what makes the two renders differ. Doctor follows the read through local variables and through functions in the same file or a relative import.",[67,118,120],{"id":119},"recommended-fix","Recommended fix",[114,122,123,124,127,128,131,132,135,136,139],{},"Initialize the state to a value the server can compute too, such as the prop default, and apply the browser value in ",[79,125,126],{},"onMounted()",". In a Nuxt app, keep state the server must render in ",[79,129,130],{},"useState()"," or ",[79,133,134],{},"useCookie()",", or render the subtree in ",[79,137,138],{},"\u003CClientOnly>",".",[67,141,143],{"id":142},"useful-links","Useful links",[145,146,147],"ul",{},[148,149,150],"li",{},[151,152,155],"a",{"href":59,"rel":153},[154],"nofollow","Rule reference",[67,157,159],{"id":158},"example","Example",[161,162,164],"h3",{"id":163},"apply-stored-layout-after-mount","Apply stored layout after mount",[114,166,167],{},"Before",[72,169,173],{"className":170,"code":171,"language":172,"meta":77,"style":77},"language-ts shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","setup(props) {\n  const stored = readLayout(props.storageKey) \u002F\u002F reads localStorage when it exists\n  const width = ref(stored.width ?? props.defaultWidth)\n}\n","ts",[79,174,175,189,224,261],{"__ignoreMap":77},[82,176,177,181,185],{"class":84,"line":85},[82,178,180],{"class":179},"s2Zo4","setup",[82,182,184],{"class":183},"sTEyZ","(props) ",[82,186,188],{"class":187},"sMK4o","{\n",[82,190,192,196,199,202,205,209,212,214,217,220],{"class":84,"line":191},2,[82,193,195],{"class":194},"spNyl","  const",[82,197,198],{"class":183}," stored",[82,200,201],{"class":187}," =",[82,203,204],{"class":179}," readLayout",[82,206,208],{"class":207},"swJcz","(",[82,210,211],{"class":183},"props",[82,213,139],{"class":187},[82,215,216],{"class":183},"storageKey",[82,218,219],{"class":207},") ",[82,221,223],{"class":222},"sHwdD","\u002F\u002F reads localStorage when it exists\n",[82,225,227,229,232,234,237,239,242,244,247,250,253,255,258],{"class":84,"line":226},3,[82,228,195],{"class":194},[82,230,231],{"class":183}," width",[82,233,201],{"class":187},[82,235,236],{"class":179}," ref",[82,238,208],{"class":207},[82,240,241],{"class":183},"stored",[82,243,139],{"class":187},[82,245,246],{"class":183},"width",[82,248,249],{"class":187}," ??",[82,251,252],{"class":183}," props",[82,254,139],{"class":187},[82,256,257],{"class":183},"defaultWidth",[82,259,260],{"class":207},")\n",[82,262,264],{"class":84,"line":263},4,[82,265,266],{"class":187},"}\n",[114,268,269],{},"After",[72,271,273],{"className":170,"code":272,"language":172,"meta":77,"style":77},"setup(props) {\n  const width = ref(props.defaultWidth)\n  onMounted(() => { width.value = readLayout(props.storageKey).width ?? width.value })\n}\n",[79,274,275,283,303,358],{"__ignoreMap":77},[82,276,277,279,281],{"class":84,"line":85},[82,278,180],{"class":179},[82,280,184],{"class":183},[82,282,188],{"class":187},[82,284,285,287,289,291,293,295,297,299,301],{"class":84,"line":191},[82,286,195],{"class":194},[82,288,231],{"class":183},[82,290,201],{"class":187},[82,292,236],{"class":179},[82,294,208],{"class":207},[82,296,211],{"class":183},[82,298,139],{"class":187},[82,300,257],{"class":183},[82,302,260],{"class":207},[82,304,305,308,310,313,316,319,321,323,326,328,330,332,334,336,338,341,343,345,347,349,351,353,356],{"class":84,"line":226},[82,306,307],{"class":179},"  onMounted",[82,309,208],{"class":207},[82,311,312],{"class":187},"()",[82,314,315],{"class":194}," =>",[82,317,318],{"class":187}," {",[82,320,231],{"class":183},[82,322,139],{"class":187},[82,324,325],{"class":183},"value",[82,327,201],{"class":187},[82,329,204],{"class":179},[82,331,208],{"class":207},[82,333,211],{"class":183},[82,335,139],{"class":187},[82,337,216],{"class":183},[82,339,340],{"class":207},")",[82,342,139],{"class":187},[82,344,246],{"class":183},[82,346,249],{"class":187},[82,348,231],{"class":183},[82,350,139],{"class":187},[82,352,325],{"class":183},[82,354,355],{"class":187}," }",[82,357,260],{"class":207},[82,359,360],{"class":84,"line":263},[82,361,266],{"class":187},[363,364,365],"style",{},"html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}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 .s2Zo4, html code.shiki .s2Zo4{--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF}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 .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 .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}",{"title":77,"searchDepth":191,"depth":191,"links":367},[368,369,370,371,372],{"id":69,"depth":191,"text":70},{"id":111,"depth":191,"text":112},{"id":119,"depth":191,"text":120},{"id":142,"depth":191,"text":143},{"id":158,"depth":191,"text":159,"children":373},[374],{"id":163,"depth":226,"text":164},"Flags ref(), reactive() and computed() state whose initial value comes from a browser read during setup of server-rendered Vue code, directly or through a helper.",[58],"md","vue",{},{"title":381},"Setup browser state","\u002Fvue\u002Frules\u002Fssr\u002Fno-setup-state-from-browser-read","Initialize the state to a value the server can compute too, such as the prop default, and apply the browser value in onMounted(). In a Nuxt app, keep state the server must render in useState() or useCookie(), or render the subtree in \u003CClientOnly>.",{"title":50,"description":375},"vue\u002Frules\u002Fssr\u002Fno-setup-state-from-browser-read","DlQva7eBLm0wTpt4PYVDKsaKtP4vNHoEUOEMhFh9rp0",1795268789968]