Enhanced ChatGPT Clone: Features Agents, MCP, Skills, DeepSeek, Anthropic, AWS, OpenAI, Responses API, Azure, Groq, o1, GPT-5, Mistral, OpenRouter, Vertex AI, Gemini, Artifacts, AI model switching, message search, Code Interpreter, langchain, DALL-E-3, OpenAPI Actions, Functions, Secure Multi-User Auth, Presets, open-source for self-hosting. Active
TypeScript aianthropicartifactsawsazurechatgptchatgpt-cloneclaudeclonedeepseekgeminigooglegpt-5librechatmcpo1openairesponses-apivisionwebui
🌄 feat: Add RouteErrorBoundary for Improved Client Error handling (#5396)
Marco Berettab8b7f40e98c7
diff --git a/client/package.json b/client/package.jsonindex 3dac89dbf3..1a5a545c1e 100644--- a/client/package.json+++ b/client/package.json@@ -79,6 +79,7 @@"react-dnd": "^16.0.1","react-dnd-html5-backend": "^16.0.1","react-dom": "^18.2.0",+ "react-error-boundary": "^5.0.0","react-flip-toolkit": "^7.1.0","react-gtm-module": "^2.0.11","react-hook-form": "^7.43.9",diff --git a/client/src/routes/RouteErrorBoundary.tsx b/client/src/routes/RouteErrorBoundary.tsxnew file mode 100644index 0000000000..082d964559--- /dev/null+++ b/client/src/routes/RouteErrorBoundary.tsx@@ -0,0 +1,216 @@+import { useRouteError } from 'react-router-dom';+import { Button } from '~/components/ui';++interface UserAgentData {+ getHighEntropyValues(hints: string[]): Promise<{ platform: string; platformVersion: string }>;+}++type PlatformInfo = {+ os: string;+ version?: string;+};++const formatStackTrace = (stack: string) => {+ return stack+ .split('\n')+ .map((line) => line.trim())+ .filter(Boolean)+ .map((line, i) => ({+ number: i + 1,+ content: line,+ }));+};++const getPlatformInfo = async (): Promise<PlatformInfo> => {+ if ('userAgentData' in navigator) {+ try {+ const ua = navigator.userAgentData as UserAgentData;+ const highEntropyValues = await ua.getHighEntropyValues(['platform', 'platformVersion']);+ return {+ os: highEntropyValues.platform,+ version: highEntropyValues.platformVersion,+ };+ } catch (e) {+ console.warn('Failed to get high entropy values:', e);+ }+ }++ const userAgent = navigator.userAgent.toLowerCase();++ if (userAgent.includes('mac')) {+ return { os: 'macOS' };+ }+ if (userAgent.includes('win')) {+ return { os: 'Windows' };+ }+ if (userAgent.includes('linux')) {+ return { os: 'Linux' };+ }+ if (userAgent.includes('android')) {+ return { os: 'Android' };+ }+ if (userAgent.includes('ios') || userAgent.includes('iphone') || userAgent.includes('ipad')) {+ return { os: 'iOS' };+ }++ return { os: 'Unknown' };+};++const getBrowserInfo = async () => {+ const platformInfo = await getPlatformInfo();+ return {+ userAgent: navigator.userAgent,+ platform: platformInfo.os,+ platformVersion: platformInfo.version,+ language: navigator.language,+ windowSize: `${window.innerWidth}x${window.innerHeight}`,+ };+};++export default function RouteErrorBoundary() {+ const typedError = useRouteError() as {+ message?: string;+ stack?: string;+ status?: number;+ statusText?: string;+ data?: unknown;+ };++ const errorDetails = {+ message: typedError.message ?? 'An unexpected error occurred',+ stack: typedError.stack,+ status: typedError.status,+ statusText: typedError.statusText,+ data: typedError.data,+ };++ const handleDownloadLogs = async () => {+ const browser = await getBrowserInfo();+ const errorLog = {+ timestamp: new Date().toISOString(),+ browser,+ error: {+ ...errorDetails,+ stack:+ errorDetails.stack != null && errorDetails.stack.trim() !== ''+ ? formatStackTrace(errorDetails.stack)+ : undefined,+ },+ };++ const blob = new Blob([JSON.stringify(errorLog, null, 2)], { type: 'application/json' });+ const url = URL.createObjectURL(blob);+ const a = document.createElement('a');+ a.href = url;+ a.download = `error-log-${new Date().toISOString()}.json`;+ document.body.appendChild(a);+ a.click();+ document.body.removeChild(a);+ URL.revokeObjectURL(url);+ };++ const handleCopyStack = async () => {+ if (errorDetails.stack != null && errorDetails.stack !== '') {+ await navigator.clipboard.writeText(errorDetails.stack);+ }+ };++ return (+ <div+ role="alert"+ className="flex min-h-screen flex-col items-center justify-center bg-surface-primary bg-gradient-to-br"+ >+ <div className="bg-surface-primary/60 mx-4 w-11/12 max-w-4xl rounded-2xl border border-border-light p-8 shadow-2xl backdrop-blur-xl">+ <h2 className="mb-6 text-center text-3xl font-medium tracking-tight text-text-primary">+ Oops! Something Unexpected Occurred+ </h2>++ {/* Error Message */}+ <div className="mb-4 rounded-xl border border-red-500/20 bg-red-500/5 p-4 text-sm text-gray-600 dark:text-gray-200">+ <h3 className="mb-2 font-medium">Error Message:</h3>+ <pre className="whitespace-pre-wrap text-sm font-light leading-relaxed text-text-primary">+ {errorDetails.message}+ </pre>+ </div>++ {/* Status Information */}+ {(typeof errorDetails.status === 'number' ||+ typeof errorDetails.statusText === 'string') && (+ <div className="mb-4 rounded-xl border border-yellow-500/20 bg-yellow-500/5 p-4 text-sm text-text-primary">+ <h3 className="mb-2 font-medium">Status:</h3>+ <p className="text-text-primary">+ {typeof errorDetails.status === 'number' && `${errorDetails.status} `}+ {typeof errorDetails.statusText === 'string' && errorDetails.statusText}+ </p>+ </div>+ )}++ {/* Stack Trace - Collapsible */}+ {errorDetails.stack != null && errorDetails.stack.trim() !== '' && (+ <details className="group mb-4 rounded-xl border border-border-light p-4">+ <summary className="mb-2 flex cursor-pointer items-center justify-between text-sm font-medium text-text-primary">+ <span>Stack Trace</span>+ <div className="flex items-center">+ <Button+ variant="outline"+ size="sm"+ onClick={handleCopyStack}+ className="ml-2 px-2 py-1 text-xs"+ >+ Copy+ </Button>+ </div>+ </summary>+ <div className="overflow-x-auto rounded-lg bg-black/5 p-4 dark:bg-white/5">+ {formatStackTrace(errorDetails.stack).map(({ number, content }) => (+ <div key={number} className="flex">+ <span className="select-none pr-4 font-mono text-xs text-text-secondary">+ {String(number).padStart(3, '0')}+ </span>+ <pre className="flex-1 font-mono text-xs leading-relaxed text-text-primary">+ {content}+ </pre>+ </div>+ ))}+ </div>+ </details>+ )}++ {/* Additional Error Data */}+ {errorDetails.data != null && (+ <details className="group mb-4 rounded-xl border border-border-light p-4">+ <summary className="mb-2 flex cursor-pointer items-center justify-between text-sm font-medium text-text-primary">+ <span>Additional Details</span>+ <span className="transition-transform group-open:rotate-90">{'>'}</span>+ </summary>+ <pre className="whitespace-pre-wrap text-xs font-light leading-relaxed text-text-primary">+ {JSON.stringify(errorDetails.data, null, 2)}+ </pre>+ </details>+ )}++ <div className="mt-6 flex flex-col gap-4">+ <p className="text-sm font-light text-text-secondary">Please try one of the following:</p>+ <ul className="list-inside list-disc text-sm text-text-secondary">+ <li>Refresh the page</li>+ <li>Clear your browser cache</li>+ <li>Check your internet connection</li>+ <li>Contact the Admin if the issue persists</li>+ </ul>+ <div className="mt-4 flex flex-col items-center gap-4 sm:flex-row sm:justify-center">+ <Button+ variant="submit"+ onClick={() => window.location.reload()}+ className="w-full sm:w-auto"+ >+ Refresh Page+ </Button>+ <Button variant="outline" onClick={handleDownloadLogs} className="w-full sm:w-auto">+ Download Error Logs+ </Button>+ </div>+ </div>+ </div>+ </div>+ );+}diff --git a/client/src/routes/index.tsx b/client/src/routes/index.tsxindex 3d87140c15..3cdfe3c46e 100644--- a/client/src/routes/index.tsx+++ b/client/src/routes/index.tsx@@ -8,6 +8,7 @@ import {ApiErrorWatcher,} from '~/components/Auth';import { AuthContextProvider } from '~/hooks/AuthContext';+import RouteErrorBoundary from './RouteErrorBoundary';import StartupLayout from './Layouts/Startup';import LoginLayout from './Layouts/Login';import dashboardRoutes from './Dashboard';@@ -27,10 +28,12 @@ export const router = createBrowserRouter([{path: 'share/:shareId',element: <ShareRoute />,+ errorElement: <RouteErrorBoundary />,},{path: '/',element: <StartupLayout />,+ errorElement: <RouteErrorBoundary />,children: [{path: 'register',@@ -49,9 +52,11 @@ export const router = createBrowserRouter([{path: 'verify',element: <VerifyEmail />,+ errorElement: <RouteErrorBoundary />,},{element: <AuthLayout />,+ errorElement: <RouteErrorBoundary />,children: [{path: '/',diff --git a/package-lock.json b/package-lock.jsonindex 40d66e13ea..0f1bdf0c94 100644--- a/package-lock.json+++ b/package-lock.json@@ -941,6 +941,7 @@"react-dnd": "^16.0.1","react-dnd-html5-backend": "^16.0.1","react-dom": "^18.2.0",+ "react-error-boundary": "^5.0.0","react-flip-toolkit": "^7.1.0","react-gtm-module": "^2.0.11","react-hook-form": "^7.43.9",@@ -29392,6 +29393,18 @@"react": "^18.2.0"}},+ "node_modules/react-error-boundary": {+ "version": "5.0.0",+ "resolved": "https://registry.npmjs.org/react-error-boundary/-/react-error-boundary-5.0.0.tgz",+ "integrity": "sha512-tnjAxG+IkpLephNcePNA7v6F/QpWLH8He65+DmedchDwg162JZqx4NmbXj0mlAYVVEd81OW7aFhmbsScYfiAFQ==",+ "license": "MIT",+ "dependencies": {+ "@babel/runtime": "^7.12.5"+ },+ "peerDependencies": {+ "react": ">=16.13.1"+ }+ },"node_modules/react-flip-toolkit": {"version": "7.1.0","resolved": "https://registry.npmjs.org/react-flip-toolkit/-/react-flip-toolkit-7.1.0.tgz",