https://nextjs.org/blog/next-15

next.js 15์˜ ์Šคํ…Œ์ด๋ธ”๋ฒ„์ „์ด ๋‚˜์™€ ์ž‘์„ฑํ•˜์˜€๋‹ค

Async Request APIs (Breaking Change)

์ „ํ†ต์ ์ธ SSR ์—์„œ๋Š” ์„œ๋ฒ„์—์„œ๋Š” ์š”์ฒญ์ด ์ „๋ถ€ ์™„๋ฃŒ๋ ๋•Œ๊นŒ์ง€ ๋ Œ๋”๋ง์„ ์ค‘์ง€ํ•œ๋‹ค. ํ•˜์ง€๋งŒ ๋ชจ๋“  ์ปดํฌ๋„ŒํŠธ๊ฐ€ ์š”์ฒญ์ด ํ•„์š”ํ•œ๊ฑด ์•„๋‹ˆ๋‹ค. ๋”ฐ๋ผ์„œ ๊ฐ€๋Šฅํ•œ ๋งŽ์€ ์ปดํฌ๋„ŒํŠธ๋ฅผ ์š”์ฒญ์ด ์ข…๋ฃŒ๋˜๊ธฐ์ „์— ์ค€๋น„ํ•˜๊ธฐ์œ„ํ•ด, ๋ช‡๋ช‡ API๋ฅผ ๋น„๋™๊ธฐ์ ์œผ๋กœ ๋ณ€๊ฒฝํ•˜์˜€๋‹ค

  • cookies, headers, draftMode
  • paramsย inย layout.js,ย page.js,ย route.js,ย default.js,ย generateMetadata, andย generateViewport
  • searchParamsย inย page.js

๋งˆ์ด๊ทธ๋ ˆ์ด์…˜์„ ์œ„ํ•ด ์ด๋Ÿฌํ•œ API๋ฅผ ๋™๊ธฐ์ ์œผ๋กœ๋„ ์ ‘๊ทผํ•  ์ˆ˜ ์žˆ์ง€๋งŒ, ๋‹ค์Œ ๋ฉ”์ด์ € ๋ฒ„์ „๊นŒ์ง€ ๊ฒฝ๊ณ ๋ฅผ ๋ฐœ์ƒ์‹œํ‚จ๋‹ค. codemod ๋˜๋Š” upgrade guide๋ฅผ ํ†ตํ•ด ๋งˆ์ด๊ทธ๋ ˆ์ด์…˜ ๊ฐ€๋Šฅํ•˜๋‹ค

npx @next/codemod@canary next-async-request-api .

Caching Semantics

APP Router ์—์„œ๋Š” ์—ฌ๋Ÿฌ ๋ถ€๋ถ„์— ์บ์‹ฑ์ด ๋””ํดํŠธ๋กœ ๋“ค์–ด๊ฐ”๋‹ค. ํ•˜์ง€๋งŒ ์ด๋Š” ๋ฐ˜๋ฐœ๋„ ๋งŽ์•„์„œ fetch, GET Route Handlers, Client Router Cache๋ฅผ ๋””ํดํŠธ๋กœ ์บ์‹ฑ๋˜์ง€ ์•Š๋„๋ก ๋ณ€๊ฒฝํ•˜์˜€๋‹ค

  • Client Router Cache no longer caches Page components by default
    • Page ์ปดํฌ๋„ŒํŠธ๋Š” staleTime์„ 0์œผ๋กœ ์„ค์ •ํ•˜์—ฌ ํ•ญ์ƒ ๋‹ค์‹œ fetch ํ•˜๋„๋ก ํ•จ
    • Shared layout data, back/forward navigation, loading.js ๋Š” ์บ์‹ฑ์ด ์ ์šฉ๋จ

React 19

์—ฌ๋Ÿฌ ํ…Œ์ŠคํŠธ๋ฅผ ๊ฑธ์นœ ๊ฒฐ๊ณผ React 19๊ฐ€ ์•ˆ์ •์ ์ด๋ผ๊ณ  ํ™•์‹ ํ•˜๊ธฐ์— App Router์—์„œ๋Š” React 19 RC๋ฅผ ์‚ฌ์šฉํ•˜๋„๋ก ํ•˜์˜€๋‹ค. ํ•˜์ง€๋งŒ Pages Route ์—์„œ๋Š” React 18 ํ˜ธํ™˜์„ฑ์„ ์ œ๊ณตํ•œ๋‹ค. ์ถ”ํ›„ React 19๊ฐ€ ์ค€๋น„๋˜์—ˆ์„๋•Œ ์—…๊ทธ๋ ˆ์ด๋“œํ•  ์ˆ˜ ์žˆ๋‹ค.

Static Route Indicator

์•„๋ž˜์™€ ๊ฐ™์€ ์ธ๋””์ผ€์ดํ„ฐ๊ฐ€ ๊ฐœ๋ฐœ๋ชจ๋“œ์—์„œ ๋‚˜ํƒ€๋‚˜ ์–ด๋–ค ๋ผ์šฐํŠธ๊ฐ€ static ์ธ์ง€ dynamic ์ธ์ง€ ํ™•์ธํ•  ์ˆ˜ ์žˆ๊ฒŒ ํ•ด์ค€๋‹ค.

Executing code after a response withย unstable_afterย (Experimental)

๋กœ๊ทธ๋ฅผ ๋‚จ๊ธฐ๊ฑฐ๋‚˜ ๋ถ„์„, ์™ธ๋ถ€ ์Šคํ† ๋ฆฌ์ง€ ์‹ฑํฌ ๋งž์ถ”๊ธฐ ๋“ฑ์€ ์œ ์ €์˜ ์š”์ฒญ๊ณผ ์ง์ ‘์ ์œผ๋กœ ๊ด€๋ จ์ด ์—†๋‹ค. ์œ ์ €์˜ ์š”์ฒญ์ด ์ด ์ž‘์—…๋“ค์„ ์ฒ˜๋ฆฌํ•˜๊ธฐ ์œ„ํ•ด ๊ธฐ๋‹ค๋ฆฌ์ง€ ์•Š๋„๋ก after()๋ผ๋Š” ์‹คํ—˜์ ์ธ API๋ฅผ ์ถ”๊ฐ€ํ•˜์˜€๋‹ค. ์œ ์ €์—๊ฒŒ ์‘๋‹ต์ด ๊ฐ€๋ฉด ๊ทธ ํ›„ ์˜ˆ์•ฝ๋œ ์ž‘์—…๋“ค์„ ์ˆ˜ํ–‰ํ•œ๋‹ค

instrumentation.jsย (Stable)

instrumentation.js ๋‚ด register() API ๊ฐ€ ์ด์ œ stable์ด๋‹ค. ์ถ”๊ฐ€์ ์œผ๋กœ onRequeestError() ๋ฅผ ์ถ”๊ฐ€ํ•˜์—ฌ ์—๋Ÿฌ๋ฅผ ์žก์„ ์ˆ˜ ์žˆ๋„๋ก ํ•˜์˜€๋‹ค

<Form>ย Component

form ์„ ๋‹ค์–‘ํ•œ ๊ธฐ๋Šฅ๊ณผ ํ•จ๊ป˜ ๋‹ค๋ฃฐ ์ˆ˜ ์žˆ๋Š” <Form> ์ปดํฌ๋„ŒํŠธ๋ฅผ ์ถ”๊ฐ€ํ•˜์˜€๋‹ค.

layout, loading UI๋ฅผ prefetch ํ•˜์—ฌ ์ œ์ถœ๋˜์—ˆ์„๋•Œ Client-side Navigation์„ ์ˆ˜ํ–‰ํ•œ๋‹ค. ๋งŒ์•ฝ JS๊ฐ€ ๋กœ๋“œ๋˜์ง€ ์•Š์•˜๋‹ค๋ฉด full-page navigation์„ ์ˆ˜ํ–‰ํ•œ๋‹ค

Improvements for self-hosting

ย Cache-Controlย ์„ ์ปค์Šคํ…€ํ•˜๊ฒŒ ์„ค์ •ํ•  ์ˆ˜ ์žˆ๋„๋ก ๋ณ€๊ฒฝ๋˜์—ˆ๋‹ค

Enhanced Security for Server Actions

๊ธฐ์กด์—๋Š” ์‚ฌ์šฉ๋˜์ง€ ์•Š๋Š” Server Action๋„ ์ ‘๊ทผ์ด ๊ฐ€๋Šฅํ–ˆ๋‹ค. ํ•˜์ง€๋งŒ ์ด์ œ๋Š” ์‚ฌ์šฉ๋˜์ง€ ์•Š๋Š” Server Action์˜ ID๊ฐ€ Client-side JS bundle์— ํฌํ•จ๋˜์ง€ ์•Š๋„๋ก ๋ณ€๊ฒฝ๋˜์—ˆ๋‹ค.

ID๋„ ๋นŒ๋“œํ• ๋•Œ๋งˆ๋‹ค ์žฌ๊ณ„์‚ฐ๋˜์–ด ์ถ”์ธกํ•  ์ˆ˜ ์—†๋„๋ก ๋ณ€๊ฒฝ๋˜์—ˆ๋‹ค.

Optimizing bundling of external packages (Stable)

์™ธ๋ถ€ ํŒจํ‚ค์ง€๋ฅผ ๋ฒˆ๋“ค๋งํ•˜๋Š” ๊ฒƒ์€ ์–ดํ”Œ๋ฆฌ์ผ€์ด์…˜ cold start ์„ฑ๋Šฅ์„ ํ–ฅ์ƒ ์‹œํ‚ฌ์ˆ˜ ์žˆ๋‹ค

App Router ์—์„œ ์™ธ๋ถ€ ํŒจํ‚ค์ง€๋Š” ๋””ํดํŠธ๋กœ ๋ฒˆ๋“ค๋˜๋ฉฐ serverExternalPackages ์˜ต์…˜์œผ๋กœ ๋ช‡๋ช‡ ํŒจํ‚ค์ง€๋ฅผ ๋บ„์ˆ˜ ์žˆ๋‹ค. Pages Router์—์„œ๋Š” ๋””ํดํŠธ๋กœ ๋ฒˆ๋“ค๋˜์ง€ ์•Š๋Š”๋ฐ, transpilePackages ์˜ต์…˜์œผ๋กœ ๋ฒˆ๋“คํ•  ํŒจํ‚ค์ง€๋ฅผ ์„ ํƒํ•  ์ˆ˜ ์žˆ๋‹ค.

์ด๋Ÿฌํ•œ ์ฐจ์ด๋ฅผ ์—†์• ๊ธฐ ์œ„ํ•ด bundlePagesRouterDependencies ์˜ต์…˜์„ ์ถ”๊ฐ€ํ•ด์„œ Page Router์—์„œ ๋””ํดํŠธ๋กœ ๋ฒˆ๋“ค๋งํ•˜๋„๋ก ํ•˜์˜€๋‹ค. ์ดํ›„ serverExternalPackages๋กœ ์ œ์™ธํ•˜๊ณ  ์‹ถ์€ ํŒจํ‚ค์ง€๋ฅผ ์ถ”๊ฐ€ํ•  ์ˆ˜ ์žˆ๋‹ค

ESLint 9 Support

ESLint 8์˜ EOL์ด ์ง€๋‚˜ ESlint 9 ์„ ์ง€์›ํ•œ๋‹ค. ํ•˜์œ„ ํ˜ธํ™˜์„ฑ์„ ๋งž์ถ”์—ˆ๊ธฐ์— ESLint 8 ์‚ฌ์šฉ์€ ๊ณ„์† ๊ฐ€๋Šฅํ•˜๋‹ค.

Development and Build Improvements

  • Server Components HMR
    • save ์‹œ ์„œ๋ฒ„์ปดํฌ๋„ŒํŠธ๋ฅผ ์žฌ์š”์ฒญํ•˜์—ฌ API ์š”์ฒญ์ด ๋ฐœ์ƒํ•˜๋Š” ๊ฒƒ์„ ๊ฐœ์„ ํ•˜์—ฌ, HMR ์‹œ fetch ์‘๋‹ต์„ ์žฌ์‚ฌ์šฉํ•˜๋„๋ก ์ˆ˜์ •ํ•˜์˜€๋‹ค
  • Faster Static Generation for the App Router
    • ๋นŒ๋“œ๊ณผ์ •์—์„œ Static Generation ์†๋„๋ฅผ ๋„คํŠธ์›Œํฌ ์š”์ฒญ๊ณผ ๊ด€๋ จํ•˜์—ฌ ๊ฐœ์„ ํ•˜์˜€๋‹ค
  • Advanced Static Generation Control
    • ๋” ๋‹ค์–‘ํ•œ ์š”๊ตฌ์‚ฌํ•ญ์— ๋Œ€์‘ํ•˜๊ธฐ ์œ„ํ•ด Static Generation ๋ฅผ ์ปจํŠธ๋กคํ•  ์ˆ˜ ์žˆ๋Š” ์˜ต์…˜์„ ์ถ”๊ฐ€ํ•˜์˜€๋‹ค.
    • ํŠน์ˆ˜ํ•œ ์š”๊ตฌ์‚ฌํ•ญ์ด ์—†๋‹ค๋ฉด ๊ทธ๋Œ€๋กœ ์œ ์ง€ํ•˜๋Š” ๊ฒƒ์ด ์ข‹๋‹ค. (์ž ์žฌ์ ์œผ๋กœ OOM, ๋ฆฌ์†Œ์Šค ๊ณผ๋‹ค์‚ฌ์šฉ์ด ๋ฐœ์ƒํ•  ์ˆ˜ ์žˆ์Œ)

Other Changes

  • [Breaking] The minimum required Node.js version has been updated to 18.18.0
  • [Improvement]ย If aย next/dynamicย component is used during SSR, the chunk will be prefetched
  • [Improvement]ย Theย experimental.allowDevelopmentBuildย option can be used to allowย NODE_ENV=developmentย withย next buildย for debugging purposes