/*** 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.** @emails react-core*/'use strict';
const ReactDOMServerIntegrationUtils = require('./utils/ReactDOMServerIntegrationTestUtils');
let React;
let ReactDOM;
let ReactDOMClient;
let ReactDOMServer;
let ReactTestUtils;
let act;
let SuspenseList;
function initModules() {
// Reset warning cache.
jest.resetModules();
React = require('react');
ReactDOM = require('react-dom');
ReactDOMClient = require('react-dom/client');
ReactDOMServer = require('react-dom/server');
ReactTestUtils = require('react-dom/test-utils');
act = require('internal-test-utils').act;
if (gate(flags => flags.enableSuspenseList)) {
SuspenseList = React.unstable_SuspenseList;
}// Make them available to the helpers.
return {
ReactDOM,
ReactDOMServer,
ReactTestUtils,
};}const {itThrowsWhenRendering, resetModules, serverRender} =
ReactDOMServerIntegrationUtils(initModules);
describe('ReactDOMServerSuspense', () => {
beforeEach(() => {
resetModules();
});function Text(props) {
return <div>{props.text}</div>;
}function AsyncText(props) {throw new Promise(() => {});}function getVisibleChildren(element) {const children = [];
let node = element.firstChild;
while (node) {if (node.nodeType === 1) {
if (node.tagName !== 'SCRIPT' &&
node.tagName !== 'TEMPLATE' &&
node.tagName !== 'template' &&
!node.hasAttribute('hidden') &&
!node.hasAttribute('aria-hidden')
) {const props = {};const attributes = node.attributes;
for (let i = 0; i < attributes.length; i++) {
if (attributes[i].name === 'id' &&
attributes[i].value.includes(':')
) {// We assume this is a React added ID that's a non-visual implementation detail.
continue;
}props[attributes[i].name] = attributes[i].value;
}props.children = getVisibleChildren(node);
children.push(React.createElement(node.tagName.toLowerCase(), props));
}} else if (node.nodeType === 3) {
children.push(node.data);
}node = node.nextSibling;
}return children.length === 0
? undefined
: children.length === 1
? children[0]
: children;
}it('should render the children when no promise is thrown', async () => {
const c = await serverRender(
<div>
<React.Suspense fallback={<Text text="Fallback" />}>
<Text text="Children" />
</React.Suspense>
</div>,
);expect(getVisibleChildren(c)).toEqual(<div>Children</div>);
});it('should render the fallback when a promise thrown', async () => {const c = await serverRender(<div><React.Suspense fallback={<Text text="Fallback" />}>
<AsyncText text="Children" /></React.Suspense>
</div>,);expect(getVisibleChildren(c)).toEqual(<div>Fallback</div>);
});it('should work with nested suspense components', async () => {const c = await serverRender(<div><React.Suspense fallback={<Text text="Fallback" />}>
<div><Text text="Children" /><React.Suspense fallback={<Text text="Fallback" />}>
<AsyncText text="Children" /></React.Suspense>
</div></React.Suspense>
</div>,);expect(getVisibleChildren(c)).toEqual(
<div><div>Children</div><div>Fallback</div></div>,);});// @gate enableSuspenseList
it('server renders a SuspenseList component and its children', async () => {
const example = (
<SuspenseList>
<React.Suspense fallback="Loading A">
<div>A</div>
</React.Suspense>
<React.Suspense fallback="Loading B">
<div>B</div>
</React.Suspense>
</SuspenseList>
);const element = await serverRender(example);const parent = element.parentNode;
const divA = parent.children[0];
expect(divA.tagName).toBe('DIV');
expect(divA.textContent).toBe('A');
const divB = parent.children[1];
expect(divB.tagName).toBe('DIV');
expect(divB.textContent).toBe('B');
await act(() => {ReactDOMClient.hydrateRoot(parent, example);
});const parent2 = element.parentNode;
const divA2 = parent2.children[0];
const divB2 = parent2.children[1];
expect(divA).toBe(divA2);
expect(divB).toBe(divB2);
});// TODO: Remove this in favor of @gate pragma
if (__EXPERIMENTAL__) {
itThrowsWhenRendering(
'a suspending component outside a Suspense node',async render => {await render(
<div><React.Suspense /><AsyncText text="Children" />
<React.Suspense />
</div>,
1,);},'A component suspended while responding to synchronous input.',
);itThrowsWhenRendering('a suspending component without a Suspense above',async render => {await render(<div><AsyncText text="Children" /></div>,1,);},'A component suspended while responding to synchronous input.',
);}it('does not get confused by throwing null', () => {function Bad() {// eslint-disable-next-line no-throw-literalthrow null;}let didError;let error;try {ReactDOMServer.renderToString(<Bad />);
} catch (err) {didError = true;error = err;}expect(didError).toBe(true);
expect(error).toBe(null);
});it('does not get confused by throwing undefined', () => {function Bad() {// eslint-disable-next-line no-throw-literalthrow undefined;}let didError;let error;try {ReactDOMServer.renderToString(<Bad />);
} catch (err) {didError = true;error = err;}expect(didError).toBe(true);
expect(error).toBe(undefined);
});it('does not get confused by throwing a primitive', () => {function Bad() {// eslint-disable-next-line no-throw-literalthrow 'foo';}let didError;let error;try {ReactDOMServer.renderToString(<Bad />);
} catch (err) {didError = true;error = err;}expect(didError).toBe(true);
expect(error).toBe('foo');
});});