From c63b873072d62c858959c2a19e68f8e2cc0b11be Mon Sep 17 00:00:00 2001
From: Sebastian Silbermann <silbermann.sebastian@gmail.com>
Date: Sat, 13 Apr 2024 11:21:10 +0200
Subject: [PATCH] fix: Improve `legacyRoot` error message (#1301)

---
 src/__tests__/render.js     | 4 ++--
 src/__tests__/renderHook.js | 2 +-
 src/pure.js                 | 8 ++++++--
 3 files changed, 9 insertions(+), 5 deletions(-)

diff --git a/src/__tests__/render.js b/src/__tests__/render.js
index 16f7dbe2..f00410b4 100644
--- a/src/__tests__/render.js
+++ b/src/__tests__/render.js
@@ -234,7 +234,7 @@ describe('render API', () => {
     expect(() => {
       render(<div />, {legacyRoot: true})
     }).toThrowErrorMatchingInlineSnapshot(
-      `\`legacyRoot: true\` is not supported in this version of React. Please use React 18 instead.`,
+      `\`legacyRoot: true\` is not supported in this version of React. If your app runs React 19 or later, you should remove this flag. If your app runs React 18 or earlier, visit https://react.dev/blog/2022/03/08/react-18-upgrade-guide for upgrade instructions.`,
     )
   })
 
@@ -259,7 +259,7 @@ describe('render API', () => {
     expect(() => {
       render(ui, {container, hydrate: true, legacyRoot: true})
     }).toThrowErrorMatchingInlineSnapshot(
-      `\`legacyRoot: true\` is not supported in this version of React. Please use React 18 instead.`,
+      `\`legacyRoot: true\` is not supported in this version of React. If your app runs React 19 or later, you should remove this flag. If your app runs React 18 or earlier, visit https://react.dev/blog/2022/03/08/react-18-upgrade-guide for upgrade instructions.`,
     )
   })
 })
diff --git a/src/__tests__/renderHook.js b/src/__tests__/renderHook.js
index c7c8b066..fe7551a2 100644
--- a/src/__tests__/renderHook.js
+++ b/src/__tests__/renderHook.js
@@ -108,6 +108,6 @@ testGateReact19('legacyRoot throws', () => {
       },
     ).result
   }).toThrowErrorMatchingInlineSnapshot(
-    `\`legacyRoot: true\` is not supported in this version of React. Please use React 18 instead.`,
+    `\`legacyRoot: true\` is not supported in this version of React. If your app runs React 19 or later, you should remove this flag. If your app runs React 18 or earlier, visit https://react.dev/blog/2022/03/08/react-18-upgrade-guide for upgrade instructions.`,
   )
 })
diff --git a/src/pure.js b/src/pure.js
index 38ec519f..f546af98 100644
--- a/src/pure.js
+++ b/src/pure.js
@@ -209,7 +209,9 @@ function render(
 ) {
   if (legacyRoot && typeof ReactDOM.render !== 'function') {
     const error = new Error(
-      '`legacyRoot: true` is not supported in this version of React. Please use React 18 instead.',
+      '`legacyRoot: true` is not supported in this version of React. ' +
+        'If your app runs React 19 or later, you should remove this flag. ' +
+        'If your app runs React 18 or earlier, visit https://react.dev/blog/2022/03/08/react-18-upgrade-guide for upgrade instructions.',
     )
     Error.captureStackTrace(error, render)
     throw error
@@ -274,7 +276,9 @@ function renderHook(renderCallback, options = {}) {
 
   if (renderOptions.legacyRoot && typeof ReactDOM.render !== 'function') {
     const error = new Error(
-      '`legacyRoot: true` is not supported in this version of React. Please use React 18 instead.',
+      '`legacyRoot: true` is not supported in this version of React. ' +
+        'If your app runs React 19 or later, you should remove this flag. ' +
+        'If your app runs React 18 or earlier, visit https://react.dev/blog/2022/03/08/react-18-upgrade-guide for upgrade instructions.',
     )
     Error.captureStackTrace(error, renderHook)
     throw error