errors/no-script-in-document.mdx - canary - githubmirror/next.js

errors/no-script-in-document.mdx

35 строк1 KB

Delba de Oliveira

docs: Move optimizing pages to guides (#78500)

24 апр 2025, 21:40

24 апр 2025, 21:4076ade73

---
title: No Script in Document
---

> Prevent usage of `next/script` in `pages/_document.js`.

> **Note**: ⚠️ This error is not relevant in Next.js versions 12.1.6 or later. Please refer to the updated [error message](/docs/messages/no-before-interactive-script-outside-document).

## Why This Error Occurred

You should not use the `next/script` component in `pages/_document.js` in Next.js versions prior to 12.1.6. That's because the `pages/_document.js` page only runs on the server and `next/script` has client-side functionality to ensure loading order.

## Possible Ways to Fix It

If you want a global script, use `next/script` in `pages/_app.js` instead.

```jsx filename="pages/_app.js"
import Script from 'next/script'

function MyApp({ Component, pageProps }) {
  return (
    <>
      <Script src="/my-script.js" />
      <Component {...pageProps} />
    </>
  )
}

export default MyApp
```

## Useful Links

- [custom-app](/docs/pages/building-your-application/routing/custom-app)
- [next-script](/docs/pages/guides/scripts)