refactor(v2): make even better SSR error notify and add tip (#4875)

packages/docusaurus/src/client/serverEntry.js

@@ -47,10 +47,21 @@ export default async function render(locals) {
   } catch (e) {
     console.error(
       chalk.red(
-        `Docusaurus Node/SSR could not render static page with path=${locals.path} because of error: ${e.message}`,
+        `Docusaurus Node/SSR could not render static page with path "${locals.path}" because of following error:\n\n${e.stack}\n`,
       ),
     );
-    throw e;
+
+    const isNotDefinedErrorRegex = /(window|document|localStorage|navigator|alert|location|buffer|self) is not defined/i;
+
+    if (isNotDefinedErrorRegex.test(e.message)) {
+      console.error(
+        chalk.green(
+          'Pro tip: It looks like you are using code that should run on the client-side only.\nTo get around it, try using <BrowserOnly> (https://docusaurus.io/docs/docusaurus-core/#browseronly) or ExecutionEnvironment (https://docusaurus.io/docs/docusaurus-core/#executionenvironment).\nIt might also require to wrap your client code in useEffect hook and/or import a third-party library dynamically (if any).',
+        ),
+      );
+    }
+
+    throw new Error('Server-side rendering fails due to the error above.');
   }
 }
 

packages/docusaurus/src/commands/build.ts

@@ -53,7 +53,7 @@ export default async function build(
         isLastLocale,
       });
     } catch (e) {
-      console.error(`error building locale=${locale}`);
+      console.error(`Unable to build website for locale ${locale}.`);
       throw e;
     }
   }