Passer de next 14.x à 15.x
Comparaison de l’API publique de next 14.2.35 et 15.5.27, calculée automatiquement à partir de leurs types TypeScript. Une signature modifiée est un changement incompatible possible, pas une certitude.
Résumé
| Chemins d’importation supprimés | 0 |
|---|---|
| Exports supprimés | 4 |
| Signatures modifiées | 10 |
| Membres de classes ou d’interfaces supprimés | 6 |
| Membres de classes ou d’interfaces modifiés | 10 |
| Nouvelles dépréciations | 5 |
| Changements d’exigences (engines, dépendances peer) | 5 |
| Nouveaux exports | 25 |
Exports supprimés
| import | export | kind | Avant |
|---|---|---|---|
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" |
Signatures modifiées
| export | Avant | Après |
|---|---|---|
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> |
Membres de classes ou d’interfaces supprimés
| member | import | Avant |
|---|---|---|
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[] |
Membres de classes ou d’interfaces modifiés
| member | Avant | Après |
|---|---|---|
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 |
Nouvelles dépréciations
| 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. |
Changements d’exigences (engines, dépendances peer)
| Avant | Après | |
|---|---|---|
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 | — | * |
Nouveaux exports (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 |
Questions fréquentes
Quels sont les changements incompatibles en passant de next 14 à 15 ?
Entre next 14.2.35 et 15.5.27, Vigia a trouvé 4 exports supprimés, 10 signatures modifiées et 16 membres de classes ou d’interfaces supprimés ou modifiés.
Qu’est-ce qui a été déprécié dans next 15 ?
5 exports ou membres sont désormais marqués comme dépréciés dans next 15.5.27.
Pour les agents
GET https://vigia.coredls.cloud/v1/packages/npm/next/upgrade?from=14.2.35&to=15.5.27