Skip to content

Commit

Permalink
Add Strict Effects to Strict Mode (#4362)
Browse files Browse the repository at this point in the history
* Add Strict Effects to Strict Mode

* Update with new thinking
  • Loading branch information
rickhanlonii committed Mar 29, 2022
1 parent 6eaf29b commit d845129
Showing 1 changed file with 49 additions and 0 deletions.
49 changes: 49 additions & 0 deletions content/docs/strict-mode.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,6 +21,7 @@ In the above example, strict mode checks will *not* be run against the `Header`
* [Warning about deprecated findDOMNode usage](#warning-about-deprecated-finddomnode-usage)
* [Detecting unexpected side effects](#detecting-unexpected-side-effects)
* [Detecting legacy context API](#detecting-legacy-context-api)
* [Detecting unsafe effects](#detecting-unsafe-effects)

Additional functionality will be added with future releases of React.

Expand Down Expand Up @@ -127,3 +128,51 @@ The legacy context API is error-prone, and will be removed in a future major ver
![](../images/blog/warn-legacy-context-in-strict-mode.png)

Read the [new context API documentation](/docs/context.html) to help migrate to the new version.


### Detecting unsafe effects {#detecting-unsafe-effects}

In the future, we’d like to add a feature that allows React to add and remove sections of the UI while preserving state. For example, when a user tabs away from a screen and back, React should be able to immediately show the previous screen. To do this, React support remounting trees using the same component state used before unmounting.

This feature will give React better performance out-of-the-box, but requires components to be resilient to effects being mounted and destroyed multiple times. Most effects will work without any changes, but some effects do not properly clean up subscriptions in the destroy callback, or implicitly assume they are only mounted or destroyed once.

To help surface these issues, React 18 introduces a new development-only check to Strict Mode. This new check will automatically unmount and remount every component, whenever a component mounts for the first time, restoring the previous state on the second mount.

To demonstrate the development behavior you'll see in Strict Mode with this feature, consider what happens when React mounts a new component. Without this change, when a component mounts, React creates the effects:

```
* React mounts the component.
* Layout effects are created.
* Effects are created.
```

With Strict Mode starting in React 18, whenever a component mounts in development, React will simulate immediately unmounting and remounting the component:

```
* React mounts the component.
* Layout effects are created.
* Effect effects are created.
* React simulates effects being destroyed on a mounted component.
* Layout effects are destroyed.
* Effects are destroyed.
* React simulates effects being re-created on a mounted component.
* Layout effects are created
* Effect setup code runs
```

On the second mount, React will restore the state from the first mount. This feature simulates user behavior such as a user tabbing away from a screen and back, ensuring that code will properly handle state restoration.

When the component unmounts, effects are destroyed as normal:

```
* React unmounts the component.
* Layout effects are destroyed.
* Effect effects are destroyed.
```

> Note:
>
> This only applies to development mode, _production behavior is unchanged_.
For help supporting common issues, see:
- [How to Support Strict Effects](https://github.com/reactwg/react-18/discussions/18)

0 comments on commit d845129

Please sign in to comment.