Skip to content

Add a warning about lack of devtool support #4803

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
lunaleaps merged 4 commits into from
Sep 17, 2025
Merged

Add a warning about lack of devtool support #4803

Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
36c79df
Add a warning about lack of devtool support
lunaleaps Sep 16, 2025
25e0743
Update virtualview.md
lunaleaps Sep 16, 2025
cefa0c2
Update docs/virtualview.md
lunaleaps Sep 17, 2025
374d965
Update virtualview.md
lunaleaps Sep 17, 2025
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
7 changes: 7 additions & 0 deletions docs/virtualview.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -41,6 +41,13 @@ Blocking the main thread can provide a better user experience by preventing flas

However, blocking the main thread also comes with tradeoffs. If an update operation, such as mounting the children of a `VirtualView`, takes too long to finish, it can now drop frames. Dropping more than a couple frames can lead to a worse user experience by making the app feel sluggish and non-responsive. Dropping too many frames may cause the operating system to display a modal indicating the app is not responsive, or it may even terminate your app!

:::warning
DevTools does not currently support debugging JavaScript on the main thread. This means if you are using breakpoints to debug code called from `onModeChange`, that is executed on the main thread, your debugger may freeze.

Debugging all other parts of your JavaScript code should work as expected. We are working on closing this gap before releasing `VirtualView` to stable channels of React Native.
:::


### Prerendering

`VirtualView` enables you to benefit from main thread rendering while mitigating the disadvantages of dropped frames by rendering earlier before it is needed. This is called “prerendering”.
Expand Down