Skip to content

[18] Updated Suspense doc with behavior during SSR and Hydration #4484

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 8 commits into from
Mar 28, 2022
Merged

[18] Updated Suspense doc with behavior during SSR and Hydration #4484

Changes from all commits
Commits
Show all changes
8 commits
Select commit Hold shift + click to select a range
0886cdf
update wording
salazarm Mar 23, 2022
cc29b3d
wording
salazarm Mar 23, 2022
340c455
update events
salazarm Mar 24, 2022
b597ecb
Update content/docs/reference-react.md
salazarm Mar 24, 2022
3baf44a
Merge branch 'react-18' into ms-18-suspense-ssr-hydration
salazarm Mar 28, 2022
3e5c24d
add link to selective hydration
salazarm Mar 28, 2022
8a88aae
rebase
salazarm Mar 28, 2022
f076381
remove some of the implementation details
salazarm Mar 28, 2022
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 8 additions & 0 deletions content/docs/reference-react.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -366,6 +366,14 @@ It is documented in our [code splitting guide](/docs/code-splitting.html#reactla

While this is not supported today, in the future we plan to let `Suspense` handle more scenarios such as data fetching. You can read about this in [our roadmap](/blog/2018/11/27/react-16-roadmap.html).

#### `React.Suspense` in Server Side Rendering
During server side rendering Suspense Boundaries allow you to flush your application in smaller chunks by suspending.
When a component suspends we schedule a low priority task to render the closest Suspense boundary's fallback. If the component unsuspends before we flush the fallback then we send down the actual content and throw away the fallback.

#### `React.Suspense` during hydration
Suspense boundaries depend on their parent boundaries being hydrated before they can hydrate, but they can hydrate independently from sibling boundaries. Events on a boundary before its hydrated will cause the boundary to hydrate at
a higher priority than neighboring boundaries. [Read more](https://github.com/reactwg/react-18/discussions/130)

### `React.startTransition` {#starttransition}

```js
Expand Down