Memperbarui next dari 14.x ke 15.x
Perbandingan API publik next 14.2.35 dan 15.5.27, dihitung otomatis dari tipe TypeScript-nya. Tanda tangan yang berubah adalah kemungkinan perubahan tidak kompatibel, bukan kepastian.
Ringkasan
| Jalur impor yang dihapus | 0 |
|---|---|
| Ekspor yang dihapus | 4 |
| Tanda tangan yang berubah | 10 |
| Anggota kelas atau antarmuka yang dihapus | 6 |
| Anggota kelas atau antarmuka yang berubah | 10 |
| Baru ditandai usang | 5 |
| Perubahan persyaratan (engines, dependensi peer) | 5 |
| Ekspor baru | 25 |
Ekspor yang dihapus
| import | export | kind | Sebelum |
|---|---|---|---|
next/constants | GOOGLE_FONT_PROVIDER | variable | "https://fonts.googleapis.com/" |
next/constants | DEV_MIDDLEWARE_MANIFEST | variable | "_devMiddlewareManifest.json" |
next/constants | OPTIMIZED_FONT_PROVIDERS | variable | { url: string; preconnect: string; }[] |
next/constants | AUTOMATIC_FONT_OPTIMIZATION_MANIFEST | variable | "font-manifest.json" |
Tanda tangan yang berubah
| export | Sebelum | Sesudah |
|---|---|---|
next · default | (options: NextServerOptions): NextServer | (options: Omit<Options | Options, "conf"> & Partial<Pick<Options | Options, "conf">> & { turbo?: boolean | undefined; turbopack?: boolean | undefined; }): NextWrapperServer |
next · PageConfig | { amp?: boolean | "hybrid" | undefined; api?: { responseLimit?: ResponseLimit | undefined; bodyParser?: false | { sizeLimit?: SizeLimit | undefined; } | undefined; externalResolver?: true | undefined; } | undefined; env?: string[] | undefined; maxDuration?: number | undefined; runtime?: ServerRuntime; unstable_runtimeJS?: false | undefined; unstable_JsPreload?: false | undefined; unstable_includeFiles?: string[] | undefined; unstable_excludeFiles?: string[] | undefined; } | { amp?: boolean | "hybrid" | undefined; api?: { responseLimit?: ResponseLimit | undefined; bodyParser?: false | { sizeLimit?: SizeLimit | undefined; } | undefined; externalResolver?: true | undefined; } | undefined; env?: string[] | undefined; maxDuration?: number | undefined; runtime?: ServerRuntime; unstable_runtimeJS?: false | undefined; unstable_JsPreload?: false | undefined; } |
next · GetStaticPathsResult | { paths: (string | { params: Params; locale?: string | undefined; })[]; fallback: boolean | "blocking"; } | { paths: (string | { params: Params; locale?: string | undefined; })[]; fallback: GetStaticPathsFallback; } |
next/link · LinkProps | { href: any; as?: any; replace?: boolean | undefined; scroll?: boolean | undefined; shallow?: boolean | undefined; passHref?: boolean | undefined; prefetch?: boolean | null | undefined; locale?: string | false | undefined; legacyBehavior?: boolean | undefined; onMouseEnter?: any; onTouchStart?: any; onClick?: any; } | interface |
next/error · ErrorProps | { statusCode: number; title?: string | undefined; withDarkMode?: boolean | undefined; } | { statusCode: number; hostname?: string | undefined; title?: string | undefined; withDarkMode?: boolean | undefined; } |
next/dynamic · DynamicOptions | LoadableGeneratedOptions & { loading?: ((loadingProps: DynamicOptionsLoadingProps) => any) | undefined; loader?: LoaderMap | Loader<P> | undefined; loadableGenerated?: LoadableGeneratedOptions | undefined; ssr?: boolean | undefined; suspense?: boolean | undefined; } | LoadableGeneratedOptions & { loading?: ((loadingProps: DynamicOptionsLoadingProps) => React.ReactNode) | undefined; loader?: LoaderMap | Loader<P> | undefined; loadableGenerated?: LoadableGeneratedOptions | undefined; ssr?: boolean | undefined; } |
next/dynamic · LoadableOptions | LoadableGeneratedOptions & { loading?: ((loadingProps: DynamicOptionsLoadingProps) => any) | undefined; loader?: LoaderMap | Loader<P> | undefined; loadableGenerated?: LoadableGeneratedOptions | undefined; ssr?: boolean | undefined; suspense?: boolean | undefined; } | LoadableGeneratedOptions & { loading?: ((loadingProps: DynamicOptionsLoadingProps) => React.ReactNode) | undefined; loader?: LoaderMap | Loader<P> | undefined; loadableGenerated?: LoadableGeneratedOptions | undefined; ssr?: boolean | undefined; } |
next/headers · cookies | (): ReadonlyRequestCookies | (): Promise<ReadonlyRequestCookies> |
next/headers · headers | (): ReadonlyHeaders | (): Promise<ReadonlyHeaders> |
next/headers · draftMode | (): DraftMode | (): Promise<DraftMode> |
Anggota kelas atau antarmuka yang dihapus
| member | import | Sebelum |
|---|---|---|
NextConfig.swcMinify | next | boolean | undefined |
NextConfig.analyticsId | next | string | undefined |
NextConfig.optimizeFonts | next | boolean | undefined |
NextConfig.outputFileTracing | next | boolean | undefined |
Router._getFlightData | next/router | (dataHref: string): Promise<{ data: string; }> |
Head.makeStylesheetInert | next/document | (node: ReactNode[]): ReactNode[] |
Anggota kelas atau antarmuka yang berubah
| member | Sebelum | Sesudah |
|---|---|---|
NextConfig.logging | { fetches?: { fullUrl?: boolean | undefined; } | undefined; } | undefined | false | LoggingConfig | undefined |
NextConfig.rewrites | (() => Promise<Rewrite[] | { beforeFiles: Rewrite[]; afterFiles: Rewrite[]; fallback: Rewrite[]; }>) | undefined | (() => Promise<Rewrite[] | { beforeFiles?: Rewrite[] | undefined; afterFiles?: Rewrite[] | undefined; fallback?: Rewrite[] | undefined; }>) | undefined |
NextConfig.sassOptions | { [key: string]: any; } | undefined | { [key: string]: any; implementation?: string | undefined; } | undefined |
NextConfig.devIndicators | { buildActivity?: boolean | undefined; buildActivityPosition?: "bottom-right" | "bottom-left" | "top-right" | "top-left" | undefined; } | undefined | false | { appIsrStatus?: boolean | undefined; buildActivity?: boolean | undefined; buildActivityPosition?: "top-left" | "top-right" | "bottom-left" | "bottom-right" | undefined; position?: "top-left" | "top-right" | "bottom-left" | "bottom-right" | undefined; } | undefined |
NextApiRequest.previewData | any | PreviewData |
NextPageContext.locales | string[] | undefined | readonly string[] | undefined |
default.static getInitialProps | ({ res, err, }: NextPageContext): ErrorProps | Promise<ErrorProps> | ({ req, res, err, }: NextPageContext): ErrorProps | Promise<ErrorProps> |
default.static origGetInitialProps | ({ res, err, }: NextPageContext): ErrorProps | Promise<ErrorProps> | ({ req, res, err, }: NextPageContext): ErrorProps | Promise<ErrorProps> |
Router.locales | string[] | undefined | readonly string[] | undefined |
Router.domainLocales | DomainLocale[] | undefined | readonly DomainLocale[] | undefined |
Baru ditandai usang
| export | @deprecated |
|---|---|
next · NextConfig.amp | built-in amp support will be removed in Next 16 |
next · NextConfig.publicRuntimeConfig | Runtime config is deprecated and will be removed in Next.js 16. |
next · NextConfig.serverRuntimeConfig | Runtime config is deprecated and will be removed in Next.js 16. |
next/config · default | Runtime config is deprecated and will be removed in Next.js 16. |
next/config · setConfig | Runtime config is deprecated and will be removed in Next.js 16. |
Perubahan persyaratan (engines, dependensi peer)
| Sebelum | Sesudah | |
|---|---|---|
engines.node | >=18.17.0 | ^18.18.0 || ^19.8.0 || >= 20.0.0 |
peerDependencies.react | ^18.2.0 | ^18.2.0 || 19.0.0-rc-de68d2f4-20241204 || ^19.0.0 |
peerDependencies.react-dom | ^18.2.0 | ^18.2.0 || 19.0.0-rc-de68d2f4-20241204 || ^19.0.0 |
peerDependencies.@playwright/test | ^1.41.2 | ^1.51.1 |
peerDependencies.babel-plugin-react-compiler | — | * |
Ekspor baru (25)
| import | export | kind |
|---|---|---|
next | NextAdapter | interface |
next | Instrumentation | namespace |
next/link | useLinkStatus | variable |
next/cache | unstable_cacheTag | variable |
next/cache | unstable_cacheLife | function |
next/cache | unstable_expireTag | variable |
next/cache | unstable_expirePath | variable |
next/server | after | variable |
next/server | connection | variable |
next/server | unstable_rootParams | variable |
next/server | UnsafeUnwrappedParams | variable |
next/server | UnsafeUnwrappedSearchParams | variable |
next/headers | UnsafeUnwrappedCookies | type |
next/headers | UnsafeUnwrappedHeaders | type |
next/headers | UnsafeUnwrappedDraftMode | type |
next/constants | WEBPACK_STATS | variable |
next/constants | AdapterOutputType | enum |
next/constants | DYNAMIC_CSS_MANIFEST | variable |
next/constants | DEV_CLIENT_MIDDLEWARE_MANIFEST | variable |
next/constants | TURBOPACK_CLIENT_BUILD_MANIFEST | variable |
next/constants | TURBOPACK_CLIENT_MIDDLEWARE_MANIFEST | variable |
next/navigation | forbidden | function |
next/navigation | unauthorized | function |
next/navigation | unstable_rethrow | variable |
next/navigation | unstable_isUnrecognizedActionError | function |
Pertanyaan umum
Apa saja perubahan tidak kompatibel saat memperbarui next dari 14 ke 15?
Antara next 14.2.35 dan 15.5.27, Vigia menemukan 4 ekspor yang dihapus, 10 tanda tangan yang berubah, dan 16 anggota kelas atau antarmuka yang dihapus atau berubah.
Apa yang ditandai usang di next 15?
5 ekspor atau anggota baru ditandai usang di next 15.5.27.
Untuk agen
GET https://vigia.coredls.cloud/v1/packages/npm/next/upgrade?from=14.2.35&to=15.5.27