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ยgenerateViewportsearchParamsย 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 ๋ ์บ์ฑ์ด ์ ์ฉ๋จ
- Page ์ปดํฌ๋ํธ๋
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์๋ต์ ์ฌ์ฌ์ฉํ๋๋ก ์์ ํ์๋ค
- save ์ ์๋ฒ์ปดํฌ๋ํธ๋ฅผ ์ฌ์์ฒญํ์ฌ API ์์ฒญ์ด ๋ฐ์ํ๋ ๊ฒ์ ๊ฐ์ ํ์ฌ, HMR ์
- 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