fix(core): ensure core error boundary is able to render theme layout #9852
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Motivation
There are cases where the core React error boundary will catch a React rendering error, and display a fallback UI, trying to eventually display that error in the current theme layout.
But due to a missing
routeContext
, the classic theme layout will always error, trigger the re-rendering of the error without the theme layout, and produce unexpected error messages unrelated to the user's mistake.Notably, the classic theme layout uses
useRouteContext()
to retrieve the current plugin name and add it to<html>
classes, for CSS targeting purposes. But the core error boundary will try to render the theme layout without and route context provider, so it crashes:We should prevent that from happening and make it possible to render caught errors inside the theme layout whenever possible.
For that reason I'm adding a kind-of artificial route context for rendering caught errors. It's not super elegant but it solves the problem.
Before:
console:
After:
console:
Test Plan
none, local test 😅
Test links
https://deploy-preview-9852--docusaurus-2.netlify.app/