resumeAndPrerenderToNodeStream
resumeAndPrerenderToNodeStream continues a prerendered React tree to a static HTML string using a a Node.js Stream..
const {prelude, postponed} = await resumeAndPrerenderToNodeStream(reactNode, postponedState, options?)
[!NOTE]
This API is specific to Node.js. Environments with Web Streams, like Deno and modern edge runtimes, should use
prerenderinstead.
Reference
resumeAndPrerenderToNodeStream(reactNode, postponedState, options?)
Call resumeAndPrerenderToNodeStream to continue a prerendered React tree to a static HTML string.
import { resumeAndPrerenderToNodeStream } from 'react-dom/static';
import { getPostponedState } from 'storage';
async function handler(request, writable) {
const postponedState = getPostponedState(request);
const { prelude } = await resumeAndPrerenderToNodeStream(<App />, JSON.parse(postponedState));
prelude.pipe(writable);
}
On the client, call hydrateRoot to make the server-generated HTML interactive.
Parameters
reactNode: The React node you calledprerender(or a previousresumeAndPrerenderToNodeStream) with. For example, a JSX element like<App />. It is expected to represent the entire document, so theAppcomponent should render the<html>tag.postponedState: The opaquepostponeobject returned from a prerender API, loaded from wherever you stored it (e.g. redis, a file, or S3).- optional
options: An object with streaming options. - optional
signal: An abort signal that lets you abort server rendering and render the rest on the client. - optional
onBrowserBailout: A callback React calls when it recovers frombrowser()by leaving a Suspense fallback for the browser to replace. It receives anErrordescribing the browser-only render and anerrorInfoobject containing thecomponentStack. If a reason was passed tobrowser, it is available aserror.cause. By default, React does nothing. See how to report browser-only rendering. - optional
onError: A callback that fires whenever there is a server error, whether recoverable or not. By default, this only callsconsole.error. If you override it to log crash reports, make sure that you still callconsole.error.
Returns
resumeAndPrerenderToNodeStream returns a Promise:
- If rendering the is successful, the Promise will resolve to an object containing:
- prelude: a Web Stream of HTML. You can use this stream to send a response in chunks, or you can read the entire stream into a string.
- postponed: an JSON-serializeable, opaque object that can be passed to resumeToNodeStream or resumeAndPrerenderToNodeStream if resumeAndPrerenderToNodeStream is aborted.
- If rendering fails, the Promise will be rejected. Use this to output a fallback shell.
Caveats
nonce is not an available option when prerendering. Nonces must be unique per request and if you use nonces to secure your application with CSP it would be inappropriate and insecure to include the nonce value in the prerender itself.
[!NOTE]
When should I use
resumeAndPrerenderToNodeStream?The static
resumeAndPrerenderToNodeStreamAPI is used for static server-side generation (SSG). UnlikerenderToString,resumeAndPrerenderToNodeStreamwaits for all data to load before resolving. This makes it suitable for generating static HTML for a full page, including data that needs to be fetched using Suspense. To stream content as it loads, use a streaming server-side render (SSR) API like renderToReadableStream.
resumeAndPrerenderToNodeStreamcan be aborted and later either continued with anotherresumeAndPrerenderToNodeStreamor resumed withresumeto support partial pre-rendering.
Usage
Further reading
resumeAndPrerenderToNodeStream behaves similarly to prerender but can be used to continue a previously started prerendering process that was aborted.
For more information about resuming a prerendered tree, see the resume documentation.
