next.js ์—์„œ๋Š” ํŽ˜์ด์ง€ ์„ฑ๋Šฅ ๊ฐœ์„ ์„ ์œ„ํ•ด ์„œ๋“œํŒŒํ‹ฐ script๋ฅผ ๊ฐ€์ ธ์˜ฌ ์ˆ˜ ์žˆ๋Š” next/script ์ปดํฌ๋„ŒํŠธ๋ฅผ ์ œ๊ณตํ•œ๋‹ค.

์‚ฌ์šฉ๋ฒ•

import

import Script from 'next/script'

Page script

ํŽ˜์ด์ง€ ์ปดํฌ๋„ŒํŠธ์—์„œ ์‚ฌ์šฉ๋  ์ˆ˜ ์žˆ์œผ๋ฉฐ, ํŽ˜์ด์ง€๊ฐ€ ๋ธŒ๋ผ์šฐ์ €์— ๋กœ๋“œ๋˜๋ฉด script๋ฅผ fetchํ•˜๊ณ  ์‹คํ–‰ํ•œ๋‹ค.

import Script from 'next/script'
 
export default function Dashboard() {
  return (
    <>
      <Script src="https://example.com/script.js" />
    </>
  )
}

Application script

๋ชจ๋“  ๊ฒฝ๋กœ์—์„œ ๊ฐ™์€ script๋ฅผ ์ถ”๊ฐ€ํ•˜๊ณ  ์‹ถ๋‹ค๋ฉด Custom App ์—์„œ ๋‹ค์Œ๊ณผ ๊ฐ™์ด ์‚ฌ์šฉํ•  ์ˆ˜ ์žˆ๋‹ค. Page script์™€ ๋งˆ์ฐฌ๊ฐ€์ง€๋กœ ํŽ˜์ด์ง€๊ฐ€ ๋กœ๋“œ๋˜๋ฉด ์Šคํฌ๋ฆฝํŠธ๋ฅผ ๊ฐ€์ ธ์˜จ๋‹ค.

// pages/_app.js
 
import Script from 'next/script'
 
export default function MyApp({ Component, pageProps }) {
  return (
    <>
      <Script src="https://example.com/script.js" />
      <Component {...pageProps} />
    </>
  )
}

์–ด๋–ค ๊ฒฝ๋กœ๋กœ ์ ‘๊ทผํ•˜๋“  ์œ„ ์Šคํฌ๋ฆฝํŠธ๋Š” ๋ถˆ๋Ÿฌ์™€์ง€๊ณ , next.js๋Š” ์œ„ script๊ฐ€ ๋”ฑ ํ•œ๋ฒˆ๋งŒ ๋ถˆ๋Ÿฌ์™€์งˆ์ˆ˜ ์žˆ๋„๋ก ๋ณด์žฅํ•œ๋‹ค. ํ•˜์ง€๋งŒ, ๋ชจ๋“  ํŽ˜์ด์ง€์—์„œ ๊ฐ™์€ script๋ฅผ ์‚ฌ์šฉํ•˜๋Š” ๊ฒฝ์šฐ๋Š” ๊ฑฐ์˜ ์—†์œผ๋‹ˆ ์“ธ๋ชจ์—†๋Š” ์„ฑ๋Šฅ ์ €ํ•˜๋ฅผ ๋ง‰๊ธฐ ์œ„ํ•ด ํŠน์ • ํŽ˜์ด์ง€์—์„œ๋งŒ script๋ฅผ ๋ถˆ๋Ÿฌ์˜ค๋„๋ก ์„ค์ •ํ•˜๋Š” ๊ฒƒ์ด ์ข‹๋‹ค.

Strategy

next/script ์ปดํฌ๋„ŒํŠธ์˜ ์†์„ฑ์ธ strategy๋ฅผ ํ†ตํ•ด ์Šคํฌ๋ฆฝํŠธ๊ฐ€ ๋ถˆ๋Ÿฌ์˜ค๋Š” ํƒ€์ด๋ฐ์— ๋Œ€ํ•ด ์„ค์ •ํ•  ์ˆ˜ ์žˆ๋‹ค.

  • beforeInteractive : ์œ ์ €์—๊ฒŒ ์ „๋‹ฌ๋˜๋Š” ์ตœ์ดˆ HTML์— ์‚ฝ์ž…๋˜๋ฉฐ, next.js ์ฝ”๋“œ๋ฅผ ๋ถˆ๋Ÿฌ์™€ hydration์ด ์ผ์–ด๋‚˜๊ธฐ ์ „์— ๋กœ๋“œํ•œ๋‹ค. ์Šคํฌ๋ฆฝํŠธ ๋กœ๋“œ๋Š” next.js ๋กœ๋“œ ์ „์— ์ด๋ค„์ง€์ง€๋งŒ, ์Šคํฌ๋ฆฝํŠธ ์‹คํ–‰์€ next.js ๋กœ๋“œ๋ฅผ ๋ง‰์ง€ ์•Š๋Š”๋‹ค.

    • Custom Document ์•ˆ์—์„œ๋งŒ ์‚ฌ์šฉํ•ด์•ผํ•œ๋‹ค. ๋”ฐ๋ผ์„œ ๋ชจ๋“  ํŽ˜์ด์ง€์—์„œ ํ•„์š”ํ•œ ์Šคํฌ๋ฆฝํŠธ์ผ ๊ฒฝ์šฐ์—๋งŒ ์‚ฌ์šฉํ•œ๋‹ค.
    • ๋˜๋Š” ๋ฐ˜๋“œ์‹œ ์ œ์ผ ๋จผ์ € ์‹คํ–‰ํ•ด์•ผํ•˜๋Š” ๊ฒฝ์šฐ์—๋งŒ ์‚ฌ์šฉํ•œ๋‹ค.
    • ex) bot detector, cookie consent managers
  • afterInteractive : ๋””ํดํŠธ ์„ค์ •์œผ๋กœ, hydration์ด ์–ด๋А์ •๋„ ์ง„ํ–‰๋œ ํ›„์— ๋ถˆ๋Ÿฌ์˜จ๋‹ค.

    • ๊ฐ€๋Šฅํ•œํ•œ ๋นจ๋ฆฌ ๋ถˆ๋Ÿฌ์™€์•ผํ•˜๋Š” ์Šคํฌ๋ฆฝํŠธ์ง€๋งŒ, next.js ์ฝ”๋“œ๋ณด๋‹ค๋Š” ๋Šฆ๊ฒŒ ๋ถˆ๋Ÿฌ์™€๋„ ๋  ๋•Œ ์‚ฌ์šฉํ•œ๋‹ค.
    • ex) Analytics
  • lazyOnload : ๋ธŒ๋ผ์šฐ์ €๊ฐ€ ํ•œ๊ฐ€ํ•  ๋•Œ ๊ฐ€์ ธ์˜จ๋‹ค.(ํ•„์š”ํ•œ ๋ชจ๋“  ๋ฆฌ์†Œ์Šค๋ฅผ ๋‹ค ๊ฐ€์ ธ์˜จ ์ƒํƒœ).

    • ex) Chat support plugins, Social media widgets
  • worker : ์›น ์›Œ์ปค ์•ˆ์—์„œ ์Šคํฌ๋ฆฝํŠธ๋ฅผ ๋ถˆ๋Ÿฌ์˜จ๋‹ค. next.js v13.1.2 ๊ธฐ์ค€์œผ๋กœ ๋ฒ ํƒ€ ๋‹จ๊ณ„์ธ ๊ธฐ๋Šฅ์ด๋‹ค.

    • ์‚ฌ์šฉํ•˜๊ธฐ ์œ„ํ•ด์„  ๋‹ค์Œ๊ณผ ๊ฐ™์ด next.config.js์— ์„ค์ •ํ•ด์ค˜์•ผํ•œ๋‹ค.
    module.exports = {
      experimental: {
        nextScriptWorkers: true,
      },
    }

Inline Scripts

๋‹ค์Œ๊ณผ ๊ฐ™์ด inline์œผ๋กœ ์Šคํฌ๋ฆฝํŠธ ์ฝ”๋“œ๋ฅผ ์ง์ ‘ ์ž‘์„ฑํ•  ์ˆ˜ ์žˆ๋‹ค. ๋‹ค๋งŒ ์ด๋•Œ๋Š” id ์†์„ฑ์„ ๋งŒ๋“œ์‹œ ์ง€์ •ํ•ด์•ผํ•œ๋‹ค.

<Script id="show-banner">
  {`document.getElementById('banner').classList.remove('hidden')`}
</Script>

dangerouslySetInnerHTML๋ฅผ ์‚ฌ์šฉํ•  ์ˆ˜๋„ ์žˆ๋‹ค.

<Script
  id="show-banner"
  dangerouslySetInnerHTML={{
    __html: `document.getElementById('banner').classList.remove('hidden')`,
  }}
/>

onLoad, onReady, onError

์Šคํฌ๋ฆฝํŠธ ๋กœ๋“œ ์ƒํƒœ์— ๋”ฐ๋ผ ๋ณ„๋„์˜ ์ฝ”๋“œ๋ฅผ ์‹คํ–‰์‹œํ‚ค๊ณ  ์‹ถ์„ ์ˆ˜ ์žˆ๋‹ค. next/script์—์„œ๋Š” ์ด๋ฅผ ์œ„ํ•ด ๋‹ค์Œ๊ณผ ๊ฐ™์€ ์†์„ฑ์„ ์ œ๊ณตํ•œ๋‹ค. ์ฝœ๋ฐฑํ•จ์ˆ˜ ์•ˆ์—์„œ๋Š” ์Šคํฌ๋ฆฝํŠธ์˜ ์ฝ”๋“œ๋ฅผ ์‚ฌ์šฉํ•  ์ˆ˜ ์ด๋‹ค.

  • onLoad : ์Šคํฌ๋ฆฝํŠธ์˜ ๋กœ๋”ฉ์ด ์ข…๋ฃŒ๋˜๋ฉด ์ฝœ๋ฐฑํ•จ์ˆ˜ ์‹คํ–‰
    • beforeInteractive ์ผ๋•Œ๋Š” ์‚ฌ์šฉํ•  ์ˆ˜ ์—†์Œ.
  • onReady: ์Šคํฌ๋ฆฝํŠธ์˜ ๋กœ๋”ฉ์ด ์ข…๋ฃŒ๋˜๊ณ , ๋„ค๋น„๊ฒŒ์ด์…˜ ๋“ฑ์œผ๋กœ ์ปดํฌ๋„ŒํŠธ๊ฐ€ ๋งˆ์šดํŠธ ๋  ๋•Œ๋งˆ๋‹ค ์ฝœ๋ฐฑํ•จ์ˆ˜ ์‹คํ–‰ํ•œ๋‹ค.
  • onError : ์Šคํฌ๋ฆฝํŠธ ๋กœ๋”ฉ์— ์‹คํŒจํ–ˆ์„ ๊ฒฝ์šฐ ์ฝœ๋ฐฑํ•จ์ˆ˜ ์‹คํ–‰
import Script from 'next/script'
 
export default function Page() {
  return (
    <>
      <Script
        src="https://cdnjs.cloudflare.com/ajax/libs/lodash.js/4.17.20/lodash.min.js"
        onLoad={() => {
          console.log(_.sample([1, 2, 3, 4]))	// lodash ์ฝ”๋“œ ์‚ฌ์šฉ๊ฐ€๋Šฅ
        }}
      />
    </>
  )
}

์ถ”๊ฐ€์ ์ธ attributes

next/script์—์„œ๋Š” ์ผ๋ฐ˜์ ์ธ <script> ํƒœ๊ทธ์˜ DOM attribute ์ค‘ next/script์—์„œ ์‚ฌ์šฉํ•˜์ง€ ์•Š๋Š” attribute๋ฅผ <script>ํƒœ๊ทธ์— ๋ถ€์—ฌํ•œ๋‹ค. ๋”ฐ๋ผ์„œ nonce๋‚˜ data-*๋กœ ์‹œ์ž‘ํ•˜๋Š” custom data attribute๋„ ์‚ฌ์šฉํ•  ์ˆ˜ ์žˆ๋‹ค.

import Script from 'next/script'
 
export default function Page() {
  return (
    <>
      <Script
        src="https://example.com/script.js"
        id="example-script"
        nonce="XUENAJFW"
        data-test="script"
      />
    </>
  )
}

์ถœ์ฒ˜

https://nextjs.org/docs/basic-features/script

review