Nitro · NITRO0009

Do not use browser APIs in Nitro server files

Browser globals are unavailable in Nitro server runtime.
NITRO0009vite-doctor/nitroservererrorSuggestion

Run this rule

pnpm vite-doctor . --framework nitro --rules nitro/server/no-browser-api

Why it matters

Nitro code can run in Node, edge, or worker runtimes where browser APIs such as window, document, and localStorage do not exist.

Use request/event data, server utilities, or move browser work to app client code.

Example

Avoid browser APIs in server handlers

Before

export default defineEventHandler(() => {
  return window.location.href
})

After

export default defineEventHandler((event) => {
  return getRequestURL(event).href
})
Copyright © 2026