ssr/no-hydration-mismatch
Disallow non-deterministic values that cause hydration mismatch.
| Default severity | Presets | Automatic fix | Options |
|---|---|---|---|
warning |
happy-path, nuxt, ecosystem, opinionated |
No | None |
Applies to: Vue SFC templates and blocks, with script context where the rule requires it.
Bad
The template evaluates Math.random() during rendering, so the server and client can produce different text for the same paragraph.
<template>
<p>{{ Math.random() }}</p>
</template>
Good
The paragraph renders the stable seed state instead of a fresh random result. In this Nuxt-style example, useState supplies the shared state and the initializer is the constant "stable".
<script setup lang="ts">
const seed = useState("seed", () => "stable");
</script>
<template>
<p>{{ seed }}</p>
</template>
Configuration (Vite+)
import { defineConfig } from "@vizejs/vite-plugin/vite-plus";
export default defineConfig({}).withVue({
linter: {
"preset": "incremental",
"rules": {
"ssr/no-hydration-mismatch": "warn"
}
},
});
Then run vp run lint.