Unverified Commit cd7fa800 authored by Josh Story's avatar Josh Story Committed by GitHub

Resolve metadata independently across parallel routes (#97345)

## Motivation

Parallel routes are separate rendering branches, but the existing
metadata resolver collects every matched slot into one shared chain. As
a result, traversal order can decide which slot supplies the document
head, and metadata errors from one slot can interfere with another.

## What this does

This adds a fork-aware resolver behind
`experimental.parallelRouteMetadata` while retaining the existing
resolver as the default. Each slot resolves metadata and viewport
independently, with isolated accumulators, and a single branch is
selected for the document head at every fork.

The built-in selector prefers real routes over implicit fallbacks and
prefers `children` when it contributes head data. Otherwise it chooses
the branch with the deepest head definition, using route depth and
lexical slot order only as stable tie-breakers.

Head selection is separate from rendering outcomes. Every slot gets its
own `MetadataOutlet`, which replays navigation and regular errors for
that slot regardless of which branch supplied the head.

## Review notes

- `generateMetadata`, `generateViewport`, and generated static metadata
still start eagerly; a fork does not serialize sibling branches or
parent/child generation.
- Branch state is isolated only where the tree forks, preventing
metadata mutation from crossing between slots.
- An outlet rejects as soon as either metadata or viewport rejects, but
resolves only after both succeed. This lets one failing result reach the
slot boundary even if the other never settles.
- Existing navigation convention metadata is preserved for the selected
branch. Errors from unselected branches remain observable only through
their own rendered outlets.
- The old resolver remains available behind an explicit flag so this
implementation can be compared or disabled during rollout.

## Verification

- `pnpm --filter=next types`
- Metadata resolver unit coverage
- Parallel-route metadata, navigation, and not-found coverage in
development and production with Turbopack and webpack

<!-- NEXT_JS_LLM -->
parent 2aaa6e81
...@@ -169,6 +169,9 @@ export function getDefineEnv({ ...@@ -169,6 +169,9 @@ export function getDefineEnv({
'process.env.__NEXT_APP_NAV_FAIL_HANDLING': Boolean( 'process.env.__NEXT_APP_NAV_FAIL_HANDLING': Boolean(
config.experimental.appNavFailHandling config.experimental.appNavFailHandling
), ),
'process.env.__NEXT_PARALLEL_ROUTE_METADATA': Boolean(
config.experimental.parallelRouteMetadata
),
'process.env.__NEXT_TURBOPACK_SHARED_RUNTIME': Boolean( 'process.env.__NEXT_TURBOPACK_SHARED_RUNTIME': Boolean(
config.experimental.turbopackSharedRuntime config.experimental.turbopackSharedRuntime
), ),
......
...@@ -937,6 +937,9 @@ export function createAppPageEntrypoint({ ...@@ -937,6 +937,9 @@ export function createAppPageEntrypoint({
optimisticRouting: Boolean( optimisticRouting: Boolean(
nextConfig.experimental.optimisticRouting nextConfig.experimental.optimisticRouting
), ),
parallelRouteMetadata: Boolean(
nextConfig.experimental.parallelRouteMetadata
),
inlineCss: Boolean(nextConfig.experimental.inlineCss), inlineCss: Boolean(nextConfig.experimental.inlineCss),
prefetchInlining: prefetchInlining:
nextConfig.experimental.prefetchInlining ?? false, nextConfig.experimental.prefetchInlining ?? false,
......
...@@ -170,6 +170,9 @@ async function requestHandler( ...@@ -170,6 +170,9 @@ async function requestHandler(
staleTimes: nextConfig.experimental.staleTimes, staleTimes: nextConfig.experimental.staleTimes,
dynamicOnHover: Boolean(nextConfig.experimental.dynamicOnHover), dynamicOnHover: Boolean(nextConfig.experimental.dynamicOnHover),
optimisticRouting: Boolean(nextConfig.experimental.optimisticRouting), optimisticRouting: Boolean(nextConfig.experimental.optimisticRouting),
parallelRouteMetadata: Boolean(
nextConfig.experimental.parallelRouteMetadata
),
inlineCss: Boolean(nextConfig.experimental.inlineCss), inlineCss: Boolean(nextConfig.experimental.inlineCss),
prefetchInlining: nextConfig.experimental.prefetchInlining ?? false, prefetchInlining: nextConfig.experimental.prefetchInlining ?? false,
authInterrupts: Boolean(nextConfig.experimental.authInterrupts), authInterrupts: Boolean(nextConfig.experimental.authInterrupts),
......
...@@ -520,6 +520,8 @@ async function exportAppImpl( ...@@ -520,6 +520,8 @@ async function exportAppImpl(
nextConfig.experimental.clientParamParsingOrigins, nextConfig.experimental.clientParamParsingOrigins,
dynamicOnHover: nextConfig.experimental.dynamicOnHover ?? false, dynamicOnHover: nextConfig.experimental.dynamicOnHover ?? false,
optimisticRouting: nextConfig.experimental.optimisticRouting ?? false, optimisticRouting: nextConfig.experimental.optimisticRouting ?? false,
parallelRouteMetadata:
nextConfig.experimental.parallelRouteMetadata ?? false,
inlineCss: nextConfig.experimental.inlineCss ?? false, inlineCss: nextConfig.experimental.inlineCss ?? false,
prefetchInlining: nextConfig.experimental.prefetchInlining ?? false, prefetchInlining: nextConfig.experimental.prefetchInlining ?? false,
authInterrupts: !!nextConfig.experimental.authInterrupts, authInterrupts: !!nextConfig.experimental.authInterrupts,
......
type CreateMetadataComponents =
typeof import('./metadata').createMetadataComponents
let createMetadataComponentsImpl: CreateMetadataComponents
if (process.env.__NEXT_PARALLEL_ROUTE_METADATA) {
createMetadataComponentsImpl = (
require('./metadata-parallel') as typeof import('./metadata-parallel')
).createMetadataComponents
} else {
createMetadataComponentsImpl = (
require('./metadata') as typeof import('./metadata')
).createMetadataComponents
}
export { createMetadataComponentsImpl as createMetadataComponents }
This diff is collapsed.
import React, { Suspense, cache } from 'react'
import type { ParsedUrlQuery } from 'querystring'
import type { Params } from '../../server/request/params'
import type { LoaderTree } from '../../server/lib/app-dir-module'
import type { SearchParams } from '../../server/request/search-params'
import { createServerSearchParamsForMetadata } from '../../server/request/search-params'
import { createServerPathnameForMetadata } from '../../server/request/pathname'
import type { MetadataErrorType } from './metadata-resolution-primitives'
import {
resolveMetadataForBranch,
resolveMetadataResolution,
resolveViewportForBranch,
} from './resolve-metadata-parallel'
import type { MetadataContext } from './types/resolvers'
import {
createMetadataElements,
createViewportElements,
} from './metadata-elements'
import {
MetadataBoundary,
ViewportBoundary,
OutletBoundary,
} from '../framework/boundary-components'
export function createMetadataComponents({
tree,
pathname,
parsedQuery,
metadataContext,
interpolatedParams,
errorType,
serveStreamingMetadata,
}: {
tree: LoaderTree
pathname: string
parsedQuery: SearchParams
metadataContext: MetadataContext
interpolatedParams: Params
errorType?: MetadataErrorType | 'redirect'
serveStreamingMetadata: boolean
}): {
Viewport: React.ComponentType
Metadata: React.ComponentType
MetadataOutlet: React.ComponentType<{ tree: LoaderTree }>
} {
const searchParams = createServerSearchParamsForMetadata(parsedQuery)
const pathnameForMetadata = createServerPathnameForMetadata(pathname)
async function Viewport() {
const tags = await getMetadataResolution(
tree,
pathnameForMetadata,
searchParams,
interpolatedParams,
metadataContext,
errorType
)
.then(async (resolution) => {
const selected = await resolution.selectedViewport
if (selected.status === 'resolved') {
return <>{createViewportElements(selected.value)}</>
}
if (
!errorType &&
(selected.status === 'not-found' ||
selected.status === 'forbidden' ||
selected.status === 'unauthorized')
) {
const convention = await getViewportForBranch(
tree,
pathnameForMetadata,
searchParams,
selected.status,
interpolatedParams,
metadataContext,
resolution.selectedKeyPath
)
if (convention.status === 'resolved') {
return <>{createViewportElements(convention.value)}</>
}
}
return null
})
.catch(() => {
// We're going to throw the error from the metadata outlet so we just render null here instead
return null
})
return tags
}
Viewport.displayName = 'Next.Viewport'
function ViewportWrapper() {
return (
<ViewportBoundary>
<Viewport />
</ViewportBoundary>
)
}
async function Metadata() {
const tags = await getResolvedParallelMetadata(
tree,
pathnameForMetadata,
searchParams,
interpolatedParams,
metadataContext,
errorType
).catch(() => {
// We're going to throw the error from the metadata outlet so we just render null here instead
return null
})
return tags
}
Metadata.displayName = 'Next.Metadata'
function MetadataWrapper() {
// TODO: We shouldn't change what we render based on whether we are streaming or not.
// If we aren't streaming we should just block the response until we have resolved the
// metadata.
if (!serveStreamingMetadata) {
return (
<MetadataBoundary>
<Metadata />
</MetadataBoundary>
)
}
return (
<div hidden>
<MetadataBoundary>
<Suspense name="Next.Metadata">
<Metadata />
</Suspense>
</MetadataBoundary>
</div>
)
}
function MetadataOutlet({ tree: outletTree }: { tree: LoaderTree }) {
const metadataResolution = getMetadataResolution(
tree,
pathnameForMetadata,
searchParams,
interpolatedParams,
metadataContext,
errorType
)
const pendingOutlet = metadataResolution.then(
(resolution) => resolution.outlets.get(outletTree) ?? null
)
// TODO: We shouldn't change what we render based on whether we are streaming or not.
// If we aren't streaming we should just block the response until we have resolved the
// metadata.
if (!serveStreamingMetadata) {
return <OutletBoundary>{pendingOutlet}</OutletBoundary>
}
return (
<OutletBoundary>
<Suspense name="Next.MetadataOutlet">{pendingOutlet}</Suspense>
</OutletBoundary>
)
}
MetadataOutlet.displayName = 'Next.MetadataOutlet'
return {
Viewport: ViewportWrapper,
Metadata: MetadataWrapper,
MetadataOutlet,
}
}
const getResolvedParallelMetadata = cache(getResolvedParallelMetadataImpl)
async function getResolvedParallelMetadataImpl(
tree: LoaderTree,
pathname: Promise<string>,
searchParams: Promise<ParsedUrlQuery>,
interpolatedParams: Params,
metadataContext: MetadataContext,
errorType: MetadataErrorType | 'redirect' | undefined
): Promise<React.ReactNode> {
const resolution = await getMetadataResolution(
tree,
pathname,
searchParams,
interpolatedParams,
metadataContext,
errorType
)
const selected = await resolution.selectedMetadata
if (selected.status === 'resolved') {
return <>{createMetadataElements(selected.value)}</>
}
if (
!errorType &&
(selected.status === 'not-found' ||
selected.status === 'forbidden' ||
selected.status === 'unauthorized')
) {
const convention = await getMetadataForBranch(
tree,
pathname,
searchParams,
selected.status,
interpolatedParams,
metadataContext,
resolution.selectedKeyPath
)
if (convention.status === 'resolved') {
return <>{createMetadataElements(convention.value)}</>
}
}
return null
}
const getMetadataResolution = cache(resolveMetadataResolutionImpl)
async function resolveMetadataResolutionImpl(
tree: LoaderTree,
pathname: Promise<string>,
searchParams: Promise<ParsedUrlQuery>,
interpolatedParams: Params,
metadataContext: MetadataContext,
errorType?: MetadataErrorType | 'redirect'
) {
const errorConvention = errorType === 'redirect' ? undefined : errorType
return resolveMetadataResolution(
tree,
pathname,
searchParams,
errorConvention,
interpolatedParams,
metadataContext
)
}
const getMetadataForBranch = cache(resolveMetadataForBranch)
const getViewportForBranch = cache(resolveViewportForBranch)
...@@ -50,20 +50,16 @@ import type { ...@@ -50,20 +50,16 @@ import type {
export type StaticIcons = Pick<ResolvedIcons, 'icon' | 'apple'> export type StaticIcons = Pick<ResolvedIcons, 'icon' | 'apple'>
export type Resolved<T> = T extends Metadata export type InstrumentedResolver<TData, TResolved> = ((
? ResolvedMetadata parent: Promise<TResolved>
: ResolvedViewport
export type InstrumentedResolver<TData> = ((
parent: Promise<Resolved<TData>>
) => TData | Promise<TData>) & { ) => TData | Promise<TData>) & {
$$original: ( $$original: (
props: unknown, props: unknown,
parent: Promise<Resolved<TData>> parent: Promise<TResolved>
) => TData | Promise<TData> ) => TData | Promise<TData>
} }
export type MetadataResolver = InstrumentedResolver<Metadata> export type MetadataResolver = InstrumentedResolver<Metadata, ResolvedMetadata>
export type ViewportResolver = InstrumentedResolver<Viewport> export type ViewportResolver = InstrumentedResolver<Viewport, ResolvedViewport>
export type MetadataErrorType = 'not-found' | 'forbidden' | 'unauthorized' export type MetadataErrorType = 'not-found' | 'forbidden' | 'unauthorized'
...@@ -227,6 +223,7 @@ export async function mergeMetadata( ...@@ -227,6 +223,7 @@ export async function mergeMetadata(
metadataContext, metadataContext,
buildState, buildState,
leafSegmentStaticIcons, leafSegmentStaticIcons,
cloneResolvedMetadata = true,
}: { }: {
metadata: Metadata | null metadata: Metadata | null
resolvedMetadata: ResolvedMetadata resolvedMetadata: ResolvedMetadata
...@@ -235,9 +232,12 @@ export async function mergeMetadata( ...@@ -235,9 +232,12 @@ export async function mergeMetadata(
metadataContext: MetadataContext metadataContext: MetadataContext
buildState: BuildState buildState: BuildState
leafSegmentStaticIcons: StaticIcons leafSegmentStaticIcons: StaticIcons
cloneResolvedMetadata?: boolean
} }
): Promise<ResolvedMetadata> { ): Promise<ResolvedMetadata> {
const newResolvedMetadata = structuredClone(resolvedMetadata) const newResolvedMetadata = cloneResolvedMetadata
? structuredClone(resolvedMetadata)
: resolvedMetadata
const metadataBase = normalizeMetadataBase( const metadataBase = normalizeMetadataBase(
metadata?.metadataBase !== undefined metadata?.metadataBase !== undefined
...@@ -457,11 +457,15 @@ export async function mergeMetadata( ...@@ -457,11 +457,15 @@ export async function mergeMetadata(
export function mergeViewport({ export function mergeViewport({
resolvedViewport, resolvedViewport,
viewport, viewport,
cloneResolvedViewport = true,
}: { }: {
resolvedViewport: ResolvedViewport resolvedViewport: ResolvedViewport
viewport: Viewport | null viewport: Viewport | null
cloneResolvedViewport?: boolean
}): ResolvedViewport { }): ResolvedViewport {
const newResolvedViewport = structuredClone(resolvedViewport) const newResolvedViewport = cloneResolvedViewport
? structuredClone(resolvedViewport)
: resolvedViewport
if (viewport) { if (viewport) {
for (const key_ in viewport) { for (const key_ in viewport) {
......
This diff is collapsed.
This diff is collapsed.
...@@ -35,7 +35,6 @@ import { ...@@ -35,7 +35,6 @@ import {
type MetadataErrorType, type MetadataErrorType,
type MetadataItems, type MetadataItems,
type PageProps, type PageProps,
type Resolved,
type SegmentProps, type SegmentProps,
type SelectedMetadata, type SelectedMetadata,
type TitleTemplates, type TitleTemplates,
...@@ -390,7 +389,7 @@ function prerenderMetadata(metadataItems: MetadataItems) { ...@@ -390,7 +389,7 @@ function prerenderMetadata(metadataItems: MetadataItems) {
> = [] > = []
for (let i = 0; i < metadataItems.length; i++) { for (let i = 0; i < metadataItems.length; i++) {
const metadataExport = metadataItems[i][0] const metadataExport = metadataItems[i][0]
getResult<Metadata>(resolversAndResults, metadataExport) getResult<Metadata, ResolvedMetadata>(resolversAndResults, metadataExport)
} }
return resolversAndResults return resolversAndResults
} }
...@@ -404,18 +403,16 @@ function prerenderViewport(viewportItems: ViewportItems) { ...@@ -404,18 +403,16 @@ function prerenderViewport(viewportItems: ViewportItems) {
> = [] > = []
for (let i = 0; i < viewportItems.length; i++) { for (let i = 0; i < viewportItems.length; i++) {
const viewportExport = viewportItems[i] const viewportExport = viewportItems[i]
getResult<Viewport>(resolversAndResults, viewportExport) getResult<Viewport, ResolvedViewport>(resolversAndResults, viewportExport)
} }
return resolversAndResults return resolversAndResults
} }
const noop = () => {} const noop = () => {}
function getResult<TData extends object>( function getResult<TData extends object, TResolved>(
resolversAndResults: Array< resolversAndResults: Array<((value: TResolved) => void) | Result<TData>>,
((value: Resolved<TData>) => void) | Result<TData> exportForResult: null | TData | InstrumentedResolver<TData, TResolved>
>,
exportForResult: null | TData | InstrumentedResolver<TData>
) { ) {
if (typeof exportForResult === 'function') { if (typeof exportForResult === 'function') {
// If the function is a 'use cache' function that uses the parent data as // If the function is a 'use cache' function that uses the parent data as
...@@ -431,7 +428,7 @@ function getResult<TData extends object>( ...@@ -431,7 +428,7 @@ function getResult<TData extends object>(
exportForResult.$$original exportForResult.$$original
) )
if (useCacheFunctionInfo && useCacheFunctionInfo.usedArgs[1]) { if (useCacheFunctionInfo && useCacheFunctionInfo.usedArgs[1]) {
const promise = new Promise<Resolved<TData>>((resolve) => const promise = new Promise<TResolved>((resolve) =>
resolversAndResults.push(resolve) resolversAndResults.push(resolve)
) )
resolversAndResults.push( resolversAndResults.push(
...@@ -447,9 +444,7 @@ function getResult<TData extends object>( ...@@ -447,9 +444,7 @@ function getResult<TData extends object>(
result = exportForResult() result = exportForResult()
} else { } else {
result = exportForResult( result = exportForResult(
new Promise<Resolved<TData>>((resolve) => new Promise<TResolved>((resolve) => resolversAndResults.push(resolve))
resolversAndResults.push(resolve)
)
) )
} }
resolversAndResults.push(result) resolversAndResults.push(result)
......
...@@ -72,7 +72,7 @@ type CreateComponentTreeProps = { ...@@ -72,7 +72,7 @@ type CreateComponentTreeProps = {
missingSlots?: Set<string> missingSlots?: Set<string>
preloadCallbacks: PreloadCallbacks preloadCallbacks: PreloadCallbacks
authInterrupts: boolean authInterrupts: boolean
MetadataOutlet: ComponentType MetadataOutlet: ComponentType<{ tree: LoaderTree }>
isPrerendering: boolean isPrerendering: boolean
hintTree: PrefetchHints | null hintTree: PrefetchHints | null
} }
...@@ -153,7 +153,7 @@ async function createComponentTreeInternal( ...@@ -153,7 +153,7 @@ async function createComponentTreeInternal(
missingSlots?: Set<string> missingSlots?: Set<string>
preloadCallbacks: PreloadCallbacks preloadCallbacks: PreloadCallbacks
authInterrupts: boolean authInterrupts: boolean
MetadataOutlet: ComponentType | null MetadataOutlet: ComponentType<{ tree: LoaderTree }> | null
isPrerendering: boolean isPrerendering: boolean
hintTree: PrefetchHints | null hintTree: PrefetchHints | null
}, },
...@@ -630,9 +630,10 @@ async function createComponentTreeInternal( ...@@ -630,9 +630,10 @@ async function createComponentTreeInternal(
missingSlots, missingSlots,
preloadCallbacks, preloadCallbacks,
authInterrupts, authInterrupts,
// `StreamingMetadataOutlet` is used to conditionally throw. In the case of parallel routes we will have more than one page MetadataOutlet:
// but we only want to throw on the first one. experimental.parallelRouteMetadata || isChildrenRouteKey
MetadataOutlet: isChildrenRouteKey ? MetadataOutlet : null, ? MetadataOutlet
: null,
isPrerendering, isPrerendering,
hintTree: childHintTree, hintTree: childHintTree,
}, },
...@@ -924,7 +925,7 @@ async function createComponentTreeInternal( ...@@ -924,7 +925,7 @@ async function createComponentTreeInternal(
}, },
wrappedPageElement, wrappedPageElement,
layerAssets, layerAssets,
MetadataOutlet ? createElement(MetadataOutlet, null) : null MetadataOutlet ? createElement(MetadataOutlet, { tree }) : null
), ),
parallelRouteNodes, parallelRouteNodes,
loadingData, loadingData,
......
...@@ -58,7 +58,7 @@ export { ...@@ -58,7 +58,7 @@ export {
} from '../request/params' } from '../request/params'
export * as serverHooks from '../../client/components/hooks-server-context' export * as serverHooks from '../../client/components/hooks-server-context'
export { HTTPAccessFallbackBoundary } from '../../client/components/http-access-fallback/error-boundary' export { HTTPAccessFallbackBoundary } from '../../client/components/http-access-fallback/error-boundary'
export { createMetadataComponents } from '../../lib/metadata/metadata' export { createMetadataComponents } from '../../lib/metadata'
export { RootLayoutBoundary } from '../../lib/framework/boundary-components' export { RootLayoutBoundary } from '../../lib/framework/boundary-components'
export { preloadStyle, preloadFont, preconnect } from './rsc/preloads' export { preloadStyle, preloadFont, preconnect } from './rsc/preloads'
......
...@@ -163,6 +163,7 @@ export interface RenderOptsPartial { ...@@ -163,6 +163,7 @@ export interface RenderOptsPartial {
clientParamParsingOrigins: string[] | undefined clientParamParsingOrigins: string[] | undefined
dynamicOnHover: boolean dynamicOnHover: boolean
optimisticRouting: boolean optimisticRouting: boolean
parallelRouteMetadata: boolean
inlineCss: boolean inlineCss: boolean
prefetchInlining: PrefetchInliningConfig prefetchInlining: PrefetchInliningConfig
authInterrupts: boolean authInterrupts: boolean
......
...@@ -70,7 +70,7 @@ export async function walkTreeWithFlightRouterState({ ...@@ -70,7 +70,7 @@ export async function walkTreeWithFlightRouterState({
rootLayoutIncluded: boolean rootLayoutIncluded: boolean
ctx: AppRenderContext ctx: AppRenderContext
preloadCallbacks: PreloadCallbacks preloadCallbacks: PreloadCallbacks
MetadataOutlet: React.ComponentType MetadataOutlet: React.ComponentType<{ tree: LoaderTree }>
hintTree: PrefetchHints | null hintTree: PrefetchHints | null
}): Promise<NavigationResponseTree | null> { }): Promise<NavigationResponseTree | null> {
const { const {
...@@ -355,7 +355,7 @@ export async function createFullTreeForNavigation({ ...@@ -355,7 +355,7 @@ export async function createFullTreeForNavigation({
injectedFontPreloadTags: Set<string> injectedFontPreloadTags: Set<string>
ctx: AppRenderContext ctx: AppRenderContext
preloadCallbacks: PreloadCallbacks preloadCallbacks: PreloadCallbacks
MetadataOutlet: React.ComponentType MetadataOutlet: React.ComponentType<{ tree: LoaderTree }>
}): Promise<NavigationResponseTree> { }): Promise<NavigationResponseTree> {
const { const {
renderOpts: { experimental }, renderOpts: { experimental },
......
...@@ -605,6 +605,8 @@ export default abstract class Server< ...@@ -605,6 +605,8 @@ export default abstract class Server<
dynamicOnHover: this.nextConfig.experimental.dynamicOnHover ?? false, dynamicOnHover: this.nextConfig.experimental.dynamicOnHover ?? false,
optimisticRouting: optimisticRouting:
this.nextConfig.experimental.optimisticRouting ?? false, this.nextConfig.experimental.optimisticRouting ?? false,
parallelRouteMetadata:
this.nextConfig.experimental.parallelRouteMetadata ?? false,
inlineCss: this.nextConfig.experimental.inlineCss ?? false, inlineCss: this.nextConfig.experimental.inlineCss ?? false,
prefetchInlining: prefetchInlining:
this.nextConfig.experimental.prefetchInlining ?? false, this.nextConfig.experimental.prefetchInlining ?? false,
......
...@@ -196,6 +196,7 @@ export const experimentalSchema = { ...@@ -196,6 +196,7 @@ export const experimentalSchema = {
useSkewCookie: z.boolean().optional(), useSkewCookie: z.boolean().optional(),
after: z.boolean().optional(), after: z.boolean().optional(),
appNavFailHandling: z.boolean().optional(), appNavFailHandling: z.boolean().optional(),
parallelRouteMetadata: z.boolean().optional(),
coldCacheBadge: z.boolean().optional(), coldCacheBadge: z.boolean().optional(),
collapseAdapterRoutes: z.boolean().optional(), collapseAdapterRoutes: z.boolean().optional(),
preloadEntriesOnStart: z.boolean().optional(), preloadEntriesOnStart: z.boolean().optional(),
......
...@@ -515,6 +515,7 @@ export interface ExperimentalConfig { ...@@ -515,6 +515,7 @@ export interface ExperimentalConfig {
cacheHandlers?: NextConfig['cacheHandlers'] cacheHandlers?: NextConfig['cacheHandlers']
multiZoneDraftMode?: boolean multiZoneDraftMode?: boolean
appNavFailHandling?: boolean appNavFailHandling?: boolean
parallelRouteMetadata?: boolean
prerenderEarlyExit?: boolean prerenderEarlyExit?: boolean
linkNoTouchStart?: boolean linkNoTouchStart?: boolean
caseSensitiveRoutes?: boolean caseSensitiveRoutes?: boolean
...@@ -2283,6 +2284,7 @@ export const defaultConfig = Object.freeze({ ...@@ -2283,6 +2284,7 @@ export const defaultConfig = Object.freeze({
cssChunking: true, cssChunking: true,
multiZoneDraftMode: false, multiZoneDraftMode: false,
appNavFailHandling: false, appNavFailHandling: false,
parallelRouteMetadata: false,
prerenderEarlyExit: true, prerenderEarlyExit: true,
serverMinification: true, serverMinification: true,
linkNoTouchStart: false, linkNoTouchStart: false,
...@@ -2454,6 +2456,7 @@ export interface NextConfigRuntime { ...@@ -2454,6 +2456,7 @@ export interface NextConfigRuntime {
| 'dynamicOnHover' | 'dynamicOnHover'
| 'useOffline' | 'useOffline'
| 'optimisticRouting' | 'optimisticRouting'
| 'parallelRouteMetadata'
| 'inlineCss' | 'inlineCss'
| 'prefetchInlining' | 'prefetchInlining'
| 'authInterrupts' | 'authInterrupts'
...@@ -2523,6 +2526,7 @@ export function getNextConfigRuntime( ...@@ -2523,6 +2526,7 @@ export function getNextConfigRuntime(
dynamicOnHover: ex.dynamicOnHover, dynamicOnHover: ex.dynamicOnHover,
useOffline: ex.useOffline, useOffline: ex.useOffline,
optimisticRouting: ex.optimisticRouting, optimisticRouting: ex.optimisticRouting,
parallelRouteMetadata: ex.parallelRouteMetadata,
inlineCss: ex.inlineCss, inlineCss: ex.inlineCss,
prefetchInlining: ex.prefetchInlining, prefetchInlining: ex.prefetchInlining,
authInterrupts: ex.authInterrupts, authInterrupts: ex.authInterrupts,
......
export async function generateMetadata() {
await Promise.resolve()
throw new Error('unrendered slot metadata error')
}
export default function ErrorSlot() {
return <div>error slot</div>
}
import { ImageResponse } from 'next/og'
export function generateImageMetadata() {
if (process.env.NEXT_PHASE === 'phase-production-build') {
return [
{
id: 'image',
size: { width: 1200, height: 630 },
contentType: 'image/png',
},
]
}
throw new Error('unrendered slot image metadata error')
}
export default function OpenGraphImage() {
return new ImageResponse(<div>image error slot</div>)
}
export default function ImageErrorSlot() {
return <div>image error slot</div>
}
import { notFound } from 'next/navigation'
export function generateMetadata() {
notFound()
}
export default function Login() {
return <div>login</div>
}
export async function generateViewport() {
await Promise.resolve()
throw new Error('unrendered slot viewport error')
}
export default function ViewportErrorSlot() {
return <div>viewport error slot</div>
}
import type { ReactNode } from 'react'
import { connection } from 'next/server'
export const metadata = {
title: {
default: 'conditional layout title',
template: '[%s]',
},
}
export default async function Layout({
children,
}: {
children: ReactNode
error: ReactNode
imageError: ReactNode
login: ReactNode
viewportError: ReactNode
}) {
// This route intentionally contains a regular metadata error in an
// unrendered slot. Keep it request-rendered so the production build can
// exercise the outlet behavior at request time.
await connection()
return children
}
export const metadata = {
title: 'conditional children title',
}
export default function Page() {
return <div id="conditional-children">conditional children</div>
}
import { markGeneratorStarted } from '../state'
export function generateMetadata() {
markGeneratorStarted('slot')
return { title: 'eager slot title' }
}
export function generateViewport() {
markGeneratorStarted('slot-viewport')
return { width: 'device-width' }
}
export default function Page() {
return <div id="eager-slot">eager slot</div>
}
import type { ReactNode } from 'react'
import { waitForGenerator } from './state'
export async function generateMetadata() {
let timeout: NodeJS.Timeout
const generatorsStartedEagerly = await Promise.race([
Promise.all([waitForGenerator('children'), waitForGenerator('slot')]).then(
() => true
),
new Promise<boolean>((resolve) => {
timeout = setTimeout(() => resolve(false), 5000)
}),
])
clearTimeout(timeout!)
return {
description: generatorsStartedEagerly
? 'parallel generators started eagerly'
: 'parallel generators were serialized',
}
}
export async function generateViewport() {
let timeout: NodeJS.Timeout
const generatorsStartedEagerly = await Promise.race([
Promise.all([
waitForGenerator('children-viewport'),
waitForGenerator('slot-viewport'),
]).then(() => true),
new Promise<boolean>((resolve) => {
timeout = setTimeout(() => resolve(false), 5000)
}),
])
clearTimeout(timeout!)
return {
colorScheme: generatorsStartedEagerly
? ('dark' as const)
: ('light' as const),
}
}
export default function Layout({
children,
slot,
}: {
children: ReactNode
slot: ReactNode
}) {
return (
<main>
{children}
{slot}
</main>
)
}
import { markGeneratorStarted } from './state'
export function generateMetadata() {
markGeneratorStarted('children')
return { title: 'eager children title' }
}
export function generateViewport() {
markGeneratorStarted('children-viewport')
return { width: 'device-width' }
}
export default function Page() {
return <div id="eager-children">eager children</div>
}
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment