/** * Copyright (c) Meta Platforms, Inc. and affiliates. * * This source code is licensed under the MIT license found in the * LICENSE file in the root directory of this source tree. * * @flow */ import type {ReactNodeList} from 'shared/ReactTypes'; import type { BootstrapScriptDescriptor, HeadersDescriptor, } from 'react-dom-bindings/src/server/ReactFizzConfigDOM'; import type { PostponedState, ErrorInfo, PostponeInfo, } from 'react-server/src/ReactFizzServer'; import type {ImportMap} from '../shared/ReactDOMTypes'; import ReactVersion from 'shared/ReactVersion'; import { createPrerenderRequest, resumeAndPrerenderRequest, startWork, startFlowing, stopFlowing, abort, getPostponedState, } from 'react-server/src/ReactFizzServer'; import { createResumableState, createRenderState, resumeRenderState, createRootFormatContext, } from 'react-dom-bindings/src/server/ReactFizzConfigDOM'; import {enablePostpone, enableHalt} from 'shared/ReactFeatureFlags'; import {ensureCorrectIsomorphicReactVersion} from '../shared/ensureCorrectIsomorphicReactVersion'; ensureCorrectIsomorphicReactVersion(); type Options = { identifierPrefix?: string, namespaceURI?: string, bootstrapScriptContent?: string, bootstrapScripts?: Array, bootstrapModules?: Array, progressiveChunkSize?: number, signal?: AbortSignal, onError?: (error: mixed, errorInfo: ErrorInfo) => ?string, onPostpone?: (reason: string, postponeInfo: PostponeInfo) => void, unstable_externalRuntimeSrc?: string | BootstrapScriptDescriptor, importMap?: ImportMap, onHeaders?: (headers: Headers) => void, maxHeadersLength?: number, }; type StaticResult = { postponed: null | PostponedState, prelude: ReadableStream, }; function prerender( children: ReactNodeList, options?: Options, ): Promise { return new Promise((resolve, reject) => { const onFatalError = reject; function onAllReady() { const stream = new ReadableStream( { type: 'bytes', pull: (controller): ?Promise => { startFlowing(request, controller); }, cancel: (reason): ?Promise => { stopFlowing(request); abort(request, reason); }, }, // $FlowFixMe[prop-missing] size() methods are not allowed on byte streams. {highWaterMark: 0}, ); const result: StaticResult = enablePostpone || enableHalt ? { postponed: getPostponedState(request), prelude: stream, } : ({ prelude: stream, }: any); resolve(result); } const onHeaders = options ? options.onHeaders : undefined; let onHeadersImpl; if (onHeaders) { onHeadersImpl = (headersDescriptor: HeadersDescriptor) => { onHeaders(new Headers(headersDescriptor)); }; } const resources = createResumableState( options ? options.identifierPrefix : undefined, options ? options.unstable_externalRuntimeSrc : undefined, options ? options.bootstrapScriptContent : undefined, options ? options.bootstrapScripts : undefined, options ? options.bootstrapModules : undefined, ); const request = createPrerenderRequest( children, resources, createRenderState( resources, undefined, // nonce is not compatible with prerendered bootstrap scripts options ? options.unstable_externalRuntimeSrc : undefined, options ? options.importMap : undefined, onHeadersImpl, options ? options.maxHeadersLength : undefined, ), createRootFormatContext(options ? options.namespaceURI : undefined), options ? options.progressiveChunkSize : undefined, options ? options.onError : undefined, onAllReady, undefined, undefined, onFatalError, options ? options.onPostpone : undefined, ); if (options && options.signal) { const signal = options.signal; if (signal.aborted) { abort(request, (signal: any).reason); } else { const listener = () => { abort(request, (signal: any).reason); signal.removeEventListener('abort', listener); }; signal.addEventListener('abort', listener); } } startWork(request); }); } type ResumeOptions = { nonce?: string, signal?: AbortSignal, onError?: (error: mixed) => ?string, onPostpone?: (reason: string) => void, unstable_externalRuntimeSrc?: string | BootstrapScriptDescriptor, }; function resumeAndPrerender( children: ReactNodeList, postponedState: PostponedState, options?: ResumeOptions, ): Promise { return new Promise((resolve, reject) => { const onFatalError = reject; function onAllReady() { const stream = new ReadableStream( { type: 'bytes', pull: (controller): ?Promise => { startFlowing(request, controller); }, cancel: (reason): ?Promise => { stopFlowing(request); abort(request, reason); }, }, // $FlowFixMe[prop-missing] size() methods are not allowed on byte streams. {highWaterMark: 0}, ); const result = { postponed: getPostponedState(request), prelude: stream, }; resolve(result); } const request = resumeAndPrerenderRequest( children, postponedState, resumeRenderState( postponedState.resumableState, options ? options.nonce : undefined, ), options ? options.onError : undefined, onAllReady, undefined, undefined, onFatalError, options ? options.onPostpone : undefined, ); if (options && options.signal) { const signal = options.signal; if (signal.aborted) { abort(request, (signal: any).reason); } else { const listener = () => { abort(request, (signal: any).reason); signal.removeEventListener('abort', listener); }; signal.addEventListener('abort', listener); } } startWork(request); }); } export {prerender, resumeAndPrerender, ReactVersion as version};