`ssr/no-browser-globals-in-ssr`

Disallow browser-only globals in SSR context

Default severity: warning
Presets: happy-path, nuxt, ecosystem, opinionated
Automatic fix: None; review the suggested change
Applies to: Vue SFC templates and blocks, with script context where the rule requires it
Options: No rule-specific options. Severity and preset selection are configurable.

Configuration (Vite+)

import { defineConfig } from "@vizejs/vite-plugin/vite-plus";

export default defineConfig({
  lint: {
    vize: {
      "preset": "incremental",
      "rules": {
        "ssr/no-browser-globals-in-ssr": "warn"
      }
    },
  },
});

vp run lint

Bad

Setup reads window.innerWidth immediately, although window does not exist when the component runs on the server.

<script setup lang="ts">
const width = window.innerWidth;
</script>

Good

The initial width is a server-safe ref value, and the browser access moves into onMounted, which runs on the client rather than during SSR setup.

<script setup lang="ts">
const width = ref(0);

onMounted(() => {
  width.value = window.innerWidth;
});
</script>

Good avoids this rule's finding under the configuration above; other rules may still report diagnostics.

Implementation · All rules