next.js์—์„œ ์‚ฌ์šฉ์ž์˜ ์š”์ฒญ์„ ๋ฐ›๊ณ , ํŽ˜์ด์ง€๋ฅผ ๋งŒ๋“ค์–ด๋‚ผ ๋•Œ ์™ธ๋ถ€ ์„œ๋ฒ„๋กœ ํ•„์š”ํ•œ ๋ฐ์ดํ„ฐ๋ฅผ ์š”์ฒญํ•ด์•ผํ•  ๋•Œ ์‚ฌ์šฉํ•˜๋Š” ๊ธฐ๋ฒ•์ด๋‹ค. data fetching์€ ๊ธฐ๋ณธ์ ์œผ๋กœ ํŽ˜์ด์ง€ ์ปดํฌ๋„ŒํŠธ์—์„œ ์‚ฌ์šฉํ•  ์ˆ˜ ์žˆ๊ณ  ๊ฒฝ์šฐ์— ๋”ฐ๋ผ Custom App ์ปดํฌ๋„ŒํŠธ์—์„œ๋„ ์‚ฌ์šฉํ•  ์ˆ˜ ์žˆ๋‹ค.

next 13๋ถ€ํ„ฐ๋Š” app/ ๊ตฌ์กฐ๋ฅผ ์‚ฌ์šฉํ•œ๋‹ค๋ฉด ์ผ๋ฐ˜ ์ปดํฌ๋„ŒํŠธ์—์„œ๋„ ๊ฐ€๋Šฅํ•˜๋‹ค๊ณ  ํ•˜์ง€๋งŒ, ํ˜„์žฌ(2023.01)๋Š” next 13์˜ app/ ๊ตฌ์กฐ๊ฐ€ ๋ฒ ํƒ€๋ฒ„์ „์ด๋ผ pages/ ๊ตฌ์กฐ๋ฅผ ๊ธฐ์ค€์œผ๋กœ ์ž‘์„ฑํ•˜์˜€๋‹ค.

Note: Next.js 13 introduces the app/ directory (beta). This new directory has support for colocated data fetching at the component level, using the new React use hook and an extended fetch Web API.

Learn more about incrementally adopting app/.

getStaticProps

  • ๋ธ”๋กœ๊ทธ ๊ฒŒ์‹œ๊ธ€์ฒ˜๋Ÿผ ๋นŒ๋“œ ์‹œ ์ด์™ธ์— ๋ณ€๊ฒฝ๋˜์ง€ ์•Š๋Š” ๊ฐ’์„ ๋ถˆ๋Ÿฌ์˜ค๊ณ  ์‹ถ๋‹ค๋ฉด getStaticProps์„ ์‚ฌ์šฉํ•œ๋‹ค.
export async function getStaticProps(context) {
  return {
    props: {}, // ํŽ˜์ด์ง€ ์ปดํฌ๋„ŒํŠธ์—์„œ ํ•„์š”ํ•œ props ๊ฐ’ ์ฃผ์ž…
  };
}
  • getStaticProps๊ฐ€ ๋งŒ๋“œ๋Š” ๊ฑด HTML, JSON ํŒŒ์ผ์ด๋‹ค.
    • HTML์—๋Š” ๋ Œ๋”๋ง๋œ ์ปดํฌ๋„ŒํŠธ๋“ค์ด ํฌํ•จ๋˜๊ณ , JSON ํŒŒ์ผ์€ getStaticProps์˜ ๊ฒฐ๊ณผ๊ฐ€ ์ €์žฅ๋œ๋‹ค.
  • ์„ฑ๋Šฅ์ด ์ข‹์•„์ง„๋‹ค.
    • ๋นŒ๋“œ ์‹œ ํ•œ๋ฒˆ ํ˜ธ์ถœ๋˜์–ด static ํŽ˜์ด์ง€๋ฅผ ์ƒ์„ฑํ•˜๊ณ , ์‚ฌ์šฉ์ž ์š”์ฒญ์ด ์ด static ํŒŒ์ผ์„ ๋ฐ˜ํ™˜ํ•˜๊ธฐ์— ๋ณ„๋„์˜ ๊ณ„์‚ฐ์ด ํ•„์š”์—†๋‹ค.
    • getStaticProps๋Š” HTML, JSON ํŒŒ์ผ์„ ๋งŒ๋“œ๋ฏ€๋กœ CDN์— ์บ์‹œ๋œ๋‹ค.

์‹คํ–‰์‹œ์ 

getStaticProps๋Š” ํ•ญ์ƒ server-side์—์„œ ์‹คํ–‰๋œ๋‹ค. ๋”ฐ๋ผ์„œ DB ์ ‘๊ทผ๊ณผ ๊ฐ™์€ ๋ฏผ๊ฐํ•œ ์ž‘์—…์„ ์ˆ˜ํ–‰ํ•  ์ˆ˜ ์žˆ๋‹ค. ์‹คํ–‰ ์‹œ์ ์€ ๋‹ค์Œ๊ณผ ๊ฐ™๋‹ค.

  • next build์‹œ์— ํ•ญ์ƒ ์‹คํ–‰๋œ๋‹ค.
  • fallback - false : ๋นŒ๋“œํƒ€์ž„์— ๋งŒ๋“ค์–ด์ง€์ง€ ์•Š์€ ํŽ˜์ด์ง€๋กœ ์š”์ฒญ์ด ๋“ค์–ด์˜ค๋ฉด 404 ๋…ธ์ถœ - true : ์ƒˆ๋กœ์šด ์ฃผ์†Œ๋กœ ์š”์ฒญ์ด ๋“ค์–ด์˜ฌ ์‹œ ๋จผ์ € fallback ํŽ˜์ด์ง€๋ฅผ ๋‚ด๋ณด๋‚ด๊ณ , getStaticProps์„ ์‹คํ–‰ํ•˜์—ฌ ๋ Œ๋”๋ง์„ ์ง„ํ–‰ํ•œ๋‹ค. ๋ Œ๋”๋ง์ด ์™„๋ฃŒ๋˜๋ฉด ์œ ์ €ํ•œํ…Œ ํŽ˜์ด์ง€๋ฅผ ๋ณด๋‚ด์ฃผ๊ณ , ์ƒˆ๋กœ ๋งŒ๋“ค์–ด์ง„ ํŽ˜์ด์ง€๋ฅผ ์ •์ ํŽ˜์ด์ง€์— ์ถ”๊ฐ€ํ•œ๋‹ค. - blocking : ์ƒˆ๋กœ์šด ์ฃผ์†Œ๋กœ ์š”์ฒญ์ด ์˜ค๋ฉด getStaticProps๋ฅผ ์‹คํ–‰ํ•˜์—ฌ ๋ Œ๋”๋ง์„ ์ง„ํ–‰ํ•œ๋‹ค. ์œ ์ €์—๊ฒŒ๋Š” fallback์„ ๋ณด๋‚ด์ง€์•Š๊ณ , ๋ Œ๋”๋ง์ด ์™„๋ฃŒ๋˜๋ฉด ์™„์„ฑ๋œ ํŽ˜์ด์ง€๋ฅผ ๋‚ด๋ณด๋‚ธ๋‹ค.
  • revalidate๋ฅผ ์‚ฌ์šฉํ•˜๋ฉด ๋ฐฑ๊ทธ๋ผ์šด๋“œ์—์„œ ์‹คํ–‰๋œ๋‹ค.
  • revalidate()๋ฅผ ์‚ฌ์šฉํ•˜๋ฉด ์ตœ์ดˆ ํŽ˜์ด์ง€ ์ ‘๊ทผ ์‹œ ๋ฐฑ๊ทธ๋ผ์šด๋“œ์—์„œ ์‹คํ–‰๋œ๋‹ค.

์ œ์•ฝ์‚ฌํ•ญ

  • getStaticProps๋Š” static HTML์„ ๋งŒ๋“œ๋ฏ€๋กœ ์œ ์ € request์— ์ ‘๊ทผํ•  ์ˆœ ์—†๋‹ค. ๋งŒ์•ฝ ์ ‘๊ทผํ•ด์•ผํ•œ๋‹ค๋ฉด Middleware๋ฅผ ์ถ”๊ฐ€ํ•˜๋ฉด ๋œ๋‹ค.
  • ํŽ˜์ด์ง€ ์ปดํฌ๋„ŒํŠธ์—์„œ๋งŒ ์‚ฌ์šฉํ•  ์ˆ˜ ์žˆ๋‹ค. _app, _document, _error์—์„œ๋„ ์‚ฌ์šฉํ•  ์ˆ˜ ์—†๋‹ค
  • production์—์„œ๋Š” ๋นŒ๋“œํƒ€์ž„์— ํ•œ๋ฒˆ ์‹คํ–‰๋˜์ง€๋งŒ, ๊ฐœ๋ฐœ ์‹œ์—๋Š” ๋งค ์š”์ฒญ๋งˆ๋‹ค ์‹คํ–‰๋œ๋‹ค.

Preview mode

preview mode๋ฅผ ์‚ฌ์šฉํ•ด ๋นŒ๋“œํƒ€์ž„ ๋Œ€์‹ ์— request time์— ์‹คํ–‰์‹œํ‚ฌ ์ˆ˜ ์žˆ๋‹ค.

getStaticPaths

  • Dynamic Route๋ฅผ ์‚ฌ์šฉํ•˜๋Š” ํŽ˜์ด์ง€์—์„œ, ๋นŒ๋“œ ์‹œ ์ •์ ์œผ๋กœ ๋ Œ๋”๋งํ•  ๊ฒฝ๋กœ ์„ค์ •.
  • getStaticPaths์—์„œ ๋ฐ˜ํ™˜๋œ ๊ฒฝ๋กœ๋Š” ๋ชจ๋‘ ์ •์ ์œผ๋กœ ๋นŒ๋“œํƒ€์ž„์— ๋ Œ๋”๋ง๋˜์–ด ์ •์ ์œผ๋กœ ์ €์žฅ๋œ๋‹ค.
  • ์ด๊ณณ์— ์ •์˜๋˜์ง€ ์•Š์€ ํ•˜์œ„ ๊ฒฝ๋กœ๋Š” ์ ‘๊ทผํ•ด๋„ ํŽ˜์ด์ง€๊ฐ€ ์•ˆ๋œฌ๋‹ค.
// pages/posts/[id].js
 
export async function getStaticPaths() {
  return {
    paths: [{ params: { id: '1' } }, { params: { id: '2' } }],
    fallback: false, // false, true, 'blocking'
  }
}
 
export async function getStaticProps(context) {
  return
    props: { post: {} },
  }
}
 
export default function Post({ post }) {
  // Render post...
}
  • getStaticPaths๋Š” getStaticProps์™€ ํ•จ๊ป˜ ์‚ฌ์šฉํ•ด์•ผํ•œ๋‹ค.
    • getStaticPaths์—์„œ ๋ฆฌํ„ดํ•œ paths๋งˆ๋‹ค getStaticProps๊ฐ€ ์‹คํ–‰๋จ.
    • fallback
      • false : ๋นŒ๋“œํƒ€์ž„์— ๋งŒ๋“ค์–ด์ง€์ง€ ์•Š์€ ํŽ˜์ด์ง€๋กœ ์š”์ฒญ์ด ๋“ค์–ด์˜ค๋ฉด 404 ๋…ธ์ถœ
      • true : ์ƒˆ๋กœ์šด ์ฃผ์†Œ๋กœ ์š”์ฒญ์ด ๋“ค์–ด์˜ฌ ์‹œ ๋จผ์ € fallback ํŽ˜์ด์ง€๋ฅผ ๋‚ด๋ณด๋‚ด๊ณ , getStaticProps์„ ์‹คํ–‰ํ•˜์—ฌ ๋ Œ๋”๋ง์„ ์ง„ํ–‰ํ•œ๋‹ค. ๋ Œ๋”๋ง์ด ์™„๋ฃŒ๋˜๋ฉด ์œ ์ €ํ•œํ…Œ ํŽ˜์ด์ง€๋ฅผ ๋ณด๋‚ด์ฃผ๊ณ , ์ƒˆ๋กœ ๋งŒ๋“ค์–ด์ง„ ํŽ˜์ด์ง€๋ฅผ ์ •์ ํŽ˜์ด์ง€์— ์ถ”๊ฐ€ํ•œ๋‹ค.
      • blocking : ์ƒˆ๋กœ์šด ์ฃผ์†Œ๋กœ ์š”์ฒญ์ด ์˜ค๋ฉด getStaticProps๋ฅผ ์‹คํ–‰ํ•˜์—ฌ ๋ Œ๋”๋ง์„ ์ง„ํ–‰ํ•œ๋‹ค. ์œ ์ €์—๊ฒŒ๋Š” fallback์„ ๋ณด๋‚ด์ง€์•Š๊ณ , ๋ Œ๋”๋ง์ด ์™„๋ฃŒ๋˜๋ฉด ์™„์„ฑ๋œ ํŽ˜์ด์ง€๋ฅผ ๋‚ด๋ณด๋‚ธ๋‹ค.

์ œ์•ฝ์‚ฌํ•ญ

  • getStaticPaths๋Š” getServerSideProps์™€ ํ•จ๊ป˜ ์“ฐ์ผ ์ˆ˜ ์—†์Œ.
  • production์—์„œ๋Š” ๋นŒ๋“œํƒ€์ž„์— ํ•œ๋ฒˆ ์‹คํ–‰๋˜์ง€๋งŒ, ๊ฐœ๋ฐœ ์‹œ์—๋Š” ๋งค ์š”์ฒญ๋งˆ๋‹ค ์‹คํ–‰๋œ๋‹ค.

์ˆ˜์š”์— ๋”ฐ๋ผ paths ์ƒ์„ฑ (Generating paths on-demand)

  • paths๋กœ ๋ฐ˜ํ™˜ํ•œ ํŽ˜์ด์ง€๊ฐ€ ๋„ˆ๋ฌด ๋งŽ์œผ๋ฉด ๋นŒ๋“œ์‹œ ์‹œ๊ฐ„์ด ์˜ค๋ž˜ ๊ฑธ๋ฆด ์ˆ˜ ์žˆ๋‹ค. ๋”ฐ๋ผ์„œ ๋นˆ ๋ฐฐ์—ด์„ ๋ฐ˜ํ™˜ํ•˜๊ณ , ํŽ˜์ด์ง€์— ์ตœ์ดˆ ์ ‘๊ทผ ์‹œ์— ๊ทธ ํŽ˜์ด์ง€๋ฅผ ๋ Œ๋”ํ•˜๋„๋ก fallback: blocking๊ณผ ํ•จ๊ป˜ ์“ฐ์ผ ์ˆ˜ ์žˆ๋‹ค.
export async function getStaticPaths() {
  // ํŽ˜์ด์ง€ ์ตœ์ดˆ ์ ‘๊ทผ์‹œ์—๋งŒ ๋ Œ๋”
  if (process.env.SKIP_BUILD_STATIC_GENERATION) {
    return {
      paths: [],
      fallback: "blocking",
    };
  }
 
  // SKIP_BUILD_STATIC_GENERATION=false ์ผ๋• paths ์ƒ์„ฑ.
  const res = await fetch("https://.../posts");
  const posts = await res.json();
 
  const paths = posts.map((post) => ({
    params: { id: post.id },
  }));
 
  return { paths, fallback: false };
}

Incremental Static Regeneration

static ํŽ˜์ด์ง€๋ฅผ ๋‹ค์‹œ ๋นŒ๋“œํ•  ํ•„์š”๊ฐ€ ์žˆ์„ ๋•Œ, ์ „์ฒด ํŽ˜์ด์ง€๋ฅผ ๋‹ค์‹œ ๋นŒ๋“œํ•  ํ•„์š”์—†์ด ๊ฐ ํŽ˜์ด์ง€๋ฅผ ์ผ์ •์‹œ๊ฐ„๋งˆ๋‹ค ์ž๋™์œผ๋กœ ๋นŒ๋“œํ•ด์„œ ์ƒˆ๋กญ๊ฒŒ ์—…๋ฐ์ดํŠธ ๋œ ํŽ˜์ด์ง€๋ฅผ ๋ณด์—ฌ์ฃผ๋Š” ๋ฐฉ๋ฒ•์ด๋‹ค.

์‚ฌ์šฉ๋ฒ•์€ getStaticProps์˜ ๋ฐ˜ํ™˜ ๊ฐ์ฒด์— revalidate๋ฅผ ์ถ”๊ฐ€ํ•˜๋ฉด ๋œ๋‹ค.

export async function getStaticProps() {
  const res = await fetch("https://.../posts");
  const posts = await res.json();
 
  return {
    props: {
      posts,
    },
    // Next.js will attempt to re-generate the page:
    // - When a request comes in
    // - At most once every 10 seconds
    revalidate: 10, // In seconds
  };
}
  1. ์ฒซ ์š”์ฒญ์ด ์˜ค๋ฉด ๋นŒ๋“œ ์‹œ ๋งŒ๋“  static ํŽ˜์ด์ง€๋ฅผ ๋ฐ˜ํ™˜ํ•œ๋‹ค.
  2. 10์ดˆ๊ฐ€ ์ง€๋‚œ ํ›„ ์ฒซ ์š”์ฒญ์—๋Š” ๋นŒ๋“œ ์‹œ ๋งŒ๋“  static ํŽ˜์ด์ง€๋ฅผ ๋ฐ˜ํ™˜ํ•œ๋‹ค.
  3. next.js๊ฐ€ ํ•ด๋‹น ํŽ˜์ด์ง€๋ฅผ ๋ฐฑ๊ทธ๋ผ์šด๋“œ์—์„œ regenerateํ•œ๋‹ค.
  4. ํŽ˜์ด์ง€๊ฐ€ ์ •์ƒ์ ์œผ๋กœ ๋นŒ๋“œ๋˜๋ฉด next.js๋Š” ์ด์ „ ํŽ˜์ด์ง€๋ฅผ invalidate ์‹œํ‚ค๊ณ , ์ƒˆ๋กœ์šด ํŽ˜์ด์ง€๋ฅผ ๋ณด์—ฌ์ค€๋‹ค. ํŽ˜์ด์ง€ ๋นŒ๋“œ๊ฐ€ ์‹คํŒจํ•˜๋ฉด ์ด์ „ ํŽ˜์ด์ง€๋ฅผ ๋ฐ˜ํ™˜ํ•˜๊ณ , ์ƒˆ๋กœ์šด ์š”์ฒญ์ด ๋“ค์–ด์˜ฌ ์‹œ ๋‹ค์‹œ ๋นŒ๋“œ๋ฅผ ์ง„ํ–‰ํ•œ๋‹ค.

on-demand Revalidation

ํŠน์ • ์ฃผ๊ธฐ๋งˆ๋‹ค regenerateํ•˜๋Š” ๋Œ€์‹ , ํ•„์š”ํ•  ๋•Œ๋งˆ๋‹ค ์—…๋ฐ์ดํŠธํ•˜๊ณ  ์‹ถ์„ ๋–„ ์‚ฌ์šฉํ•œ๋‹ค.

  1. secret key๋ฅผ ์ƒ์„ฑํ›„, ๋‹ค์Œ ์ฃผ์†Œ๋กœ ์š”์ฒญ์„ ๋ณด๋‚ธ๋‹ค.

    https://<your-site.com>/api/revalidate?secret=<token>
    
  2. secret key๋ฅผ ํ™˜๊ฒฝ๋ณ€์ˆ˜์— ์ถ”๊ฐ€ํ•˜๊ณ , api/revalidate๋ฅผ ๋‹ค์Œ๊ณผ ๊ฐ™์ด ๊ตฌ์„ฑํ•œ๋‹ค.

    // pages/api/revalidate.js
     
    export default async function handler(req, res) {
      if (req.query.secret !== process.env.MY_SECRET_TOKEN) {
        return res.status(401).json({ message: 'Invalid token' })
      }
     
      try {
        await res.revalidate('/path-to-revalidate')
        return res.json({ revalidated: true })
      } catch (err)
        return res.status(500).send('Error revalidating')
      }
    }

์ฃผ์˜์‚ฌํ•ญ

  • CDN์—์„œ ์บ์‹œ๊ฐ€ ์ผ์–ด๋‚˜๋ฉด ISR์ด ์ ์ ˆํ•˜๊ฒŒ ๋™์ž‘ํ•˜์ง€ ์•Š๋Š”๋‹ค. useCdn : false ์˜ต์…˜์„ ์‚ฌ์šฉํ•  ์ˆ˜ ์žˆ๋‹ค.

getServerSideProps

  • ๋งค ์š”์ฒญ๋งˆ๋‹ค ์ƒˆ๋กญ๊ฒŒ ๊ฐ’์„ ๋ถˆ๋Ÿฌ์™€์•ผํ•  ๊ฒฝ์šฐ ์‚ฌ์šฉ.
export async function getServerSideProps(context) {
	return {
	    props: {}, // will be passed to the page component as props
    };
}
  • ๋ชจ๋“  ์š”์ฒญ์— ๋Œ€ํ•œ ๊ณ„์‚ฐ์„ ํ•ด์•ผํ•˜๊ณ , CDN ์บ์‹œ ์ ์šฉ์ด ๋˜์ง€ ์•Š๊ธฐ์— ๋” ๋А๋ฆฌ๋‹ค. ๋”ฐ๋ผ์„œ ๊ผญ ๋งค๋ฒˆ ์ƒˆ๋กญ๊ฒŒ ๋ถˆ๋Ÿฌ์™€์•ผํ•  ๊ฒฝ์šฐ์—๋งŒ ์‚ฌ์šฉํ•œ๋‹ค.
  • ๋˜ํ•œ ๊ผญ ์ฒซ html์— ๋ฐ์ดํ„ฐ๊ฐ€ ๋ฐ˜์˜๋˜์ง€ ์•Š์•„๋„ ๋˜๋Š” ํŽ˜์ด์ง€๋ผ๋ฉด, ํด๋ผ์ด์–ธํŠธ ๋‹จ์—์„œ ๋ฐ์ดํ„ฐ๋ฅผ ๊ฐ€์ ธ์˜ค๋Š” ๊ฒƒ์ด ์ข‹๋‹ค. (next์—์„œ ์ œ์ž‘ํ•œ swr์„ ์‚ฌ์šฉํ•˜๋ฉด ํŽธํ•˜๋‹ค)
  • getServerSideProps๋Š” ๋นŒ๋“œ์‹œ ๋ฒˆ๋“ค๋กœ ๋ฌถ์ด์ง€ ์•Š๋Š”๋‹ค. ๋”ฐ๋ผ์„œ ํด๋ผ์ด์–ธํŠธ ์‚ฌ์ด๋“œ์— ์ „๋‹ฌ๋„ ๋˜์ง€ ์•Š๋Š”๋‹ค. ๊ทธ๋ ‡๊ธฐ์— ์„œ๋ฒ„์‚ฌ์ด๋“œ์—์„œ๋งŒ ์‹คํ–‰ํ•ด์•ผํ•˜๋Š” ์ฝ”๋“œ(DB ํ˜ธ์ถœ)๋ฅผ ์‚ฌ์šฉํ•˜๊ธฐ์— ์ข‹๋‹ค.
    • ๋ธŒ๋ผ์šฐ์ €์—์„œ ์‹คํ–‰๋˜์ง€ ์•Š๊ธฐ์— window.document์™€ ๊ฐ™์€ ๋ธŒ๋ผ์šฐ์ € API๋ฅผ ์‚ฌ์šฉํ•  ์ˆ˜ ์—†๋‹ค.

Context

context๋ฅผ ์ธ์ž๋กœ ๋ฐ›๋Š”๋ฐ, ๋‹ค์Œ๊ณผ ๊ฐ™์€ ํ•„๋“œ๊ฐ€ ํฌํ•จ๋˜์–ด์žˆ๋‹ค.

  • params : dynamic route๋ฅผ ์‚ฌ์šฉ ์‹œ, ๋ผ์šฐํŒ… ํŒŒ๋ผ๋ฏธํ„ฐ๊ฐ€ ๋‹ด๊ฒจ์žˆ๋‹ค.
  • req : HTTP IncomingMessage object์— cookies๋ฅผ ํฌํ•จํ•œ ๊ฐ์ฒด์ด๋‹ค.
  • res : HTTP response object ๊ฐ์ฒด
  • query : dynamic route ํŒŒ๋ผ๋ฏธํ„ฐ๋ฅผ ํฌํ•จํ•œ ์ฟผ๋ฆฌ์ŠคํŠธ๋ง์ด ๋‹ด๊ฒจ์žˆ๋‹ค.
  • preview : ํŽ˜์ด์ง€๊ฐ€ Preview Mode๋ผ๋ฉด true์ด๊ณ , ์•„๋‹ˆ๋ฉด false์ด๋‹ค
  • previewData : setPreviewData๋กœ ์„ค์ •๋œ preview ๋ฐ์ดํ„ฐ๊ฐ€ ๋‹ด๊ฒจ์žˆ๋‹ค.
  • resolveUrl : URL์˜ ์ •๊ทœํ™”๋œ ์ •๋ณด๋ฅผ ํฌํ•จํ•จ
  • locale : ์„ค์ •๋œ locale ๊ฐ’
  • locales : ์ง€์›ํ•˜๋Š” locales ํฌํ•จ
  • defaultLocale : default locale๋กœ ์„ค์ •๋œ ๊ฐ’

Return values

getServerSideProps์—์„œ๋Š” ๋‹ค์Œ๊ณผ ๊ฐ™์€ ๋ฐ์ดํ„ฐ๋ฅผ ๋ฐ˜ํ™˜ํ•  ์ˆ˜ ์žˆ๊ณ , ๊ฐ ๋ฐ˜ํ™˜๊ฐ’์— ๋”ฐ๋ผ ํŽ˜์ด์ง€ ๋ Œ๋”๋ง์ด ๋‹ฌ๋ผ์ง„๋‹ค.

  • props : ํŽ˜์ด์ง€ ์ปดํฌ๋„ŒํŠธ๋กœ ์ „๋‹ฌ๋˜๋Š” ๋ฐ์ดํ„ฐ๋ฅผ ๋‹ด๋Š”๋‹ค. ์ผ๋ฐ˜์ ์œผ๋กœ ์‚ฌ์šฉํ•˜๋Š” ๋ฐ˜ํ™˜๊ฐ’์œผ๋กœ, props๋กœ ๋„˜์–ด๊ฐ„ ๋ฐ์ดํ„ฐ ๊ฐ€์ง€๊ณ  ํŽ˜์ด์ง€ ์ปดํฌ๋„ŒํŠธ๊ฐ€ ๋ Œ๋”๋งํ•œ๋‹ค.

    export async function getServerSideProps(context) {
      return {
        props: { message: `Next.js is awesome` }, // will be passed to the page component as props
      };
    }
  • notFound : boolean ๊ฐ’์„ ๋‹ด๋Š”๋‹ค. true์ผ ๊ฒฝ์šฐ ํŽ˜์ด์ง€ ์ปดํฌ๋„ŒํŠธ๋ฅผ ๋ Œ๋”๋งํ•˜์ง€ ์•Š๊ณ  404 ์ฝ”๋“œ๋ฅผ ๋‚ธ๋‹ค.

    export async function getServerSideProps(context) {
      const res = await fetch(`https://.../data`);
      const data = await res.json();
     
      if (!data) {
        return {
          notFound: true,
        };
      }
     
      return {
        props: { data }, // will be passed to the page component as props
      };
    }
  • redirect : ๋‹ค๋ฅธ ํŽ˜์ด์ง€๋กœ ๋ฆฌ๋‹ค์ด๋ ‰ํŠธ ์‹œํ‚ฌ ๋•Œ ์‚ฌ์šฉํ•œ๋‹ค. statusCode ํ•„๋“œ๋ฅผ ์ถ”๊ฐ€ํ•  ์ˆ˜ ์žˆ์œผ๋‚˜, ๊ทธ๋Ÿด๋ ค๋ฉด permanent ํ•„๋“œ๋ฅผ ์„ค์ •ํ•˜๋ฉด ์•ˆ๋œ๋‹ค. (redirect permanent๋ž€?)

    export async function getServerSideProps(context) {
      const res = await fetch(`https://.../data`);
      const data = await res.json();
     
      if (!data) {
        return {
          redirect: {
            destination: "/",
            permanent: false,
          },
        };
      }
     
      return {
        props: {}, // will be passed to the page component as props
      };
    }

with Typescript

ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ์™€ ํ•จ๊ป˜ ์‚ฌ์šฉํ•  ๋•Œ ํƒ€์ดํ•‘ ๊ธฐ๋ฒ•๋“ค์€ ๋‹ค์Œ๊ณผ ๊ฐ™๋‹ค.

import { GetServerSideProps } from 'next'
 
type Data = { ... }
 
export const getServerSideProps: GetServerSideProps<{ data: Data }> = async (context) => {
  const res = await fetch('https://.../data')
  const data: Data = await res.json()
 
  return {
    props: {
      data,
    },
  }
}

์ถ”๋ก ๋œ ํƒ€์ž…์„ ์‚ฌ์šฉํ•˜๊ณ  ์‹ถ์œผ๋ฉด ๋‹ค์Œ๊ณผ ๊ฐ™์ด ํ•  ์ˆ˜ ์žˆ๋‹ค.

import { InferGetServerSidePropsType } from 'next'
 
type Data = { ... }
 
export const getServerSideProps = async () => {
  const res = await fetch('https://.../data')
  const data: Data = await res.json()
 
  return {
    props: {
      data,
    },
  }
}
 
function Page({ data }: InferGetServerSidePropsType<typeof getServerSideProps>) {
  // will resolve data to type Data
}
 
export default Page

getInitialProps

getServerSideProps์™€ ๊ฐ™์ด ์„œ๋ฒ„์‚ฌ์ด๋“œ์—์„œ ํŽ˜์ด์ง€ ์ปดํฌ๋„ŒํŠธ๋ฅผ ๋ Œ๋”ํ•˜๊ธฐ ์ „์— ํ•„์š”ํ•œ ๋ฐ์ดํ„ฐ๋ฅผ ๋ถˆ๋Ÿฌ์˜ค๊ธฐ ์œ„ํ•œ ๋ฉ”์„œ๋“œ์ด๋‹ค( getStaticProps, getStaticPaths์˜ ๊ธฐ๋Šฅ์€ ์—†์Œ). next v9 ์ด์ „์— ์‚ฌ์šฉํ•˜์˜€์œผ๋ฉฐ ๊ทธ ์ดํ›„์—๋Š” getServerSideProps๊ฐ€ ์‚ฌ์šฉ๋œ๋‹ค. ํ•˜์ง€๋งŒ ๋ ˆ๊ฑฐ์‹œ ์ฝ”๋“œ๋ฅผ ์ฝ์„ ๋•Œ ํ•„์š”ํ•˜๋‹ˆ ์•Œ์•„๋‘˜ ํ•„์š”๊ฐ€ ์žˆ๋‹ค.

export default function Page({ stars }) {
  return <div>Next stars: {stars}</div>;
}
 
Page.getInitialProps = async (ctx: NextPageContext) => {
  const res = await fetch("https://api.github.com/repos/vercel/next.js");
  const json = await res.json();
  return { stars: json.stargazers_count };
};

getServerSideProps์™€ ์ฐจ์ด์ 

  • ๋นŒ๋“œ์‹œ ๋ฒˆ๋“ค๋กœ ๋ฌถ์ธ๋‹ค. ์ฒซ ํŽ˜์ด์ง€ ๋ Œ๋”์‹œ์—๋Š” ์„œ๋ฒ„์—์„œ ์‹คํ–‰๋˜๋Š”๋ฐ, next/link, next/router๋กœ ํŽ˜์ด์ง€ ๋„ค๋น„์ผ€์ดํŒ… ๋์„ ์‹œ์—๋Š” ํด๋ผ์ด์–ธํŠธ์—์„œ ์‹คํ–‰๋œ๋‹ค.
    • but getInitialProps๊ฐ€ Custom App ์ปดํฌ๋„ŒํŠธ์— ์žˆ๊ณ , ๋„ค๋น„๊ฒŒ์ดํŒ…๋œ ํŽ˜์ด์ง€๊ฐ€ getServerSideProps๋ฅผ ์‚ฌ์šฉ์ค‘์ด๋ผ๋ฉด, ์„œ๋ฒ„์—์„œ ์‹คํ–‰๋œ๋‹ค.
  • ์ธ์ž๋กœ ๋ฐ›๋Š” context์˜ ๊ตฌ์„ฑ์ด ๋‹ค๋ฅด๋‹ค.
    • pathname: ํ˜„์žฌ ๋ผ์šฐํŠธ.
    • req : HTTP IncomingMessage object์— cookies๋ฅผ ํฌํ•จํ•œ ๊ฐ์ฒด์ด๋‹ค.
    • res : HTTP response object ๊ฐ์ฒด
    • query : dynamic route ํŒŒ๋ผ๋ฏธํ„ฐ๋ฅผ ํฌํ•จํ•œ ์ฟผ๋ฆฌ์ŠคํŠธ๋ง์ด ๋‹ด๊ฒจ์žˆ๋‹ค.
    • asPath : ๋ธŒ๋ผ์šฐ์ €์—์„œ ๋ณด์—ฌ์ง€๋Š” ์ฟผ๋ฆฌ๋ฅผ ํฌํ•จํ•œ ์‹ค์ œ path
    • err : ๋ Œ๋”๋ง ์ค‘ ์ผ์–ด๋‚œ ์—๋Ÿฌ

์ฃผ์˜์‚ฌํ•ญ

  • ํ•œ ํŽ˜์ด์ง€ ์ปดํฌ๋„ŒํŠธ์—์„œ๋Š” ํ•˜๋‚˜์˜ getInitialProps๋งŒ ์‹คํ–‰๋จ.
    • ๋”ฐ๋ผ์„œ _app.tsx์™€ ํŽ˜์ด์ง€ ์ปดํฌ๋„ŒํŠธ ๋‘˜ ๋‹ค getInitialProps๊ฐ€ ์žˆ๋‹ค๋ฉด ๋จผ์ € ์‹คํ–‰๋˜๋Š” _app.tsx์˜ getInitialProps๋งŒ ์‹คํ–‰๋œ๋‹ค.

    • ๋งŒ์•ฝ ํŽ˜์ด์ง€ ์ปดํฌ๋„ŒํŠธ์˜ getInitialProps๋ฅผ ์‹คํ–‰ํ•˜๋ ค๋ฉด _app.tsx๋ฅผ ๋‹ค์Œ๊ณผ ๊ฐ™์ด ๋ณ€๊ฒฝํ•ด์•ผํ•œ๋‹ค.

      function MyApp({ Component, pageProps }) {
        return <Component ponent {...pageProps} />;
      }
       
      MyApp.getInitialProps = async ({ Component, ctx }) => {
        let pageProps = {};
        // ํ•˜์œ„ ์ปดํฌ๋„ŒํŠธ์— getInitialProps๊ฐ€ ์žˆ๋‹ค๋ฉด ์ถ”๊ฐ€ (๊ฐ ๊ฐœ๋ณ„ ์ปดํฌ๋„ŒํŠธ์—์„œ ์‚ฌ์šฉํ•  ๊ฐ’ ์ถ”๊ฐ€)
        if (Component.getInitialProps) {
          pageProps = await Component.getInitialProps(ctx);
        }
       
        // _app์—์„œ props ์ถ”๊ฐ€ (๋ชจ๋“  ์ปดํฌ๋„ŒํŠธ์—์„œ ๊ณตํ†ต์ ์œผ๋กœ ์‚ฌ์šฉํ•  ๊ฐ’ ์ถ”๊ฐ€)
        pageProps = { ...pageProps, posttt: { title: 11111, content: 3333 } };
       
        return { pageProps };
      };
       
      export default MyApp;

shallow route๋กœ ํ™”๋ฉด์ „ํ™˜ ์ตœ์ ํ™”

๊ฐ™์€ ํŽ˜์ด์ง€ ๋‚ด์—์„œ ํ™”๋ฉด์€ ๊ฐ™์€๋ฐ url๋งŒ ๋ฐ”๋€Œ๋Š” ๊ฒฝ์šฐ, url์ด ๋ณ€๊ฒฝ๋  ๋–„๋งˆ๋‹ค ์„œ๋ฒ„์— ์ƒˆ๋กœ์šด ํŽ˜์ด์ง€๋ฅผ ๋‹ฌ๋ผ๊ณ  ์š”์ฒญ์„ ๋ณด๋‚ธ๋‹ค๊ณ  ํ•ด๋ณด์ž. ๊ทธ๋Ÿผ getServerProps๋‚˜ getInitialProps๊ฐ€ ๋งค๋ฒˆ ์‹คํ–‰๋˜์–ด ์„œ๋ฒ„์˜ ์—ฐ์‚ฐ์ด ๋„ˆ๋ฌด ๋งŽ์•„์ง€๊ฒŒ ๋œ๋‹ค. ์ด๋•Œ ์‚ฌ์šฉํ•  ์ˆ˜ ์žˆ๋Š” ๊ฒƒ์ด shallow route์ด๋‹ค

๋ฐฉ๋ฒ•์€ ์•„๋ž˜์™€ ๊ฐ™์ด router ๊ฐ์ฒด๋ฅผ ์‚ฌ์šฉํ•˜์—ฌ ์“ธ ์ˆ˜ ์žˆ๋‹ค.

router.push(
  {
    pathname: "/cars?model=bmw",
    query: { ...values, page: 1 }, // ์ƒํƒœ๊ฐ’ ์ „๋‹ฌ๊ฐ€๋Šฅ
  },
  undefined,
  { shallow: true } // shallow route
);

ํŽ˜์ด์ง€ ๋ณ€๊ฒฝ ๊ฐ์ง€๋Š” useEffect ๋˜๋Š” componentDidUpdate์—์„œ ๊ฐ€๋Šฅํ•˜๋‹ค

componentDidUpdate(prevProps) {
  const { pathname, query } = this.props.router
  // verify props have changed to avoid an infinite loop
  if (query.counter !== prevProps.router.query.counter) {
    // fetch data based on the new query
  }
}
 

์ด๋•Œ shallow routing์€ ๋™์ผ ํŽ˜์ด์ง€์˜ url ๋ณ€๊ฒฝ์—์„œ๋งŒ ๋™์ž‘ํ•˜๊ณ , ๋‹ค๋ฅธ ํŽ˜์ด์ง€๋กœ ์ด๋™ํ•  ๋•Œ๋Š” getInitalProps๊ฐ€ ๊ทธ๋Œ€๋กœ ์‹คํ–‰๋œ๋‹ค. ๋‹ค์Œ ์˜ˆ์‹œ๋Š” ๋‹ค๋ฅธ ํŽ˜์ด์ง€๋กœ ์ด๋™ํ•˜๋Š” ์˜ˆ์‹œ๋‹ค.

router.push(
  {
    pathname: "/users",
    query: { ...values, page: 1 },
  },
  undefined,
  { shallow: true }
);

์ถœ์ฒ˜

https://kyounghwan01.github.io/blog/React/next/getInitialProps/#%E1%84%8C%E1%85%AE%E1%84%8B%E1%85%B4%E1%84%89%E1%85%A1%E1%84%92%E1%85%A1%E1%86%BC

https://nextjs.org/docs/basic-features/data-fetching/get-static-props

https://develogger.kro.kr/blog/LKHcoding/133

review