Error Code Lookup Notes

WHAT IT DOES

Error Code Lookup Notes is a browser extension that automatically scans the current webpage for error codes, HTTP status codes, system error messages, exception codes, and API error responses. It detects error-related elements by examining class names, IDs, data attributes, and text patterns for keywords like "error", "exception", "failed", "status", and common error code formats (ERR_*, E*, EXCEPTION_*, ERROR_*, HTTP status codes, Java exceptions, and UUID-style error IDs). The extension adds a floating "lookup error" button (🔍) next to each detected error code, allowing you to capture error details, error messages, context, and custom notes with a single click. Clicking the button opens a panel where you can look up the error code online via DuckDuckGo, Google, Stack Overflow, or GitHub (configurable), add resolution notes, and store lookup data locally. The extension maintains a complete error lookup database per error code with resolution history, solution notes, and tags for each tracked error. The main panel displays all tracked errors, showing the latest resolution status, entry count, and any notes. Errors can be marked as resolved or left open, and tags help categorize and filter errors. All data is stored locally in your browser using GM_setValue, ensuring your error tracking information persists across page reloads and browser sessions. This helps developers, QA engineers, DevOps teams, and support staff track, resolve, and document error patterns across different systems and applications.

WHERE IT RUNS

This extension runs on any webpage that displays error codes, HTTP status codes, system error messages, exception codes, or API error responses – including web applications, API documentation, error monitoring dashboards, logging interfaces, development environments, staging systems, production applications, and any page containing error-related content. The extension intelligently adapts to different page structures and supports a wide range of common error display patterns. No manual configuration is required per site; the extension automatically detects error elements using a flexible pattern matching system. This makes it ideal for developers debugging applications, support teams triaging issues, and anyone who needs to track and resolve errors across multiple systems.

HOW TO USE

Simply install the extension and navigate to any webpage displaying error codes. The extension automatically detects error elements and places a small "lookup error" button (🔍) next to each one. Click any of these buttons to open the error lookup panel with the error code, type, and context pre-filled. Use the "Search Online" button to open a search for the error code in your preferred search engine, Stack Overflow, or GitHub. Add resolution notes, additional observations, and tags to categorize the error, then click "Save Error Record" to store it in your local database. A floating button (❌) appears in the bottom-right corner of the page – click this to open the main panel. The main panel shows all tracked errors, sorted by most recent entry, with error code, type, resolution status, entry count, and latest note displayed. Click any error card to view detailed history, including all logged entries with timestamps, resolution notes, and tags. Use the settings section to enable or disable auto-detection and choose your preferred search source for error lookups.

ONE TECHNICAL SECTION – WHY IT WORKS

The extension employs a multi-layered detection system that identifies error codes with high accuracy. First, it scans the DOM using a comprehensive set of CSS selectors targeting common error-related class patterns, IDs, and data attributes like "error", "exception", "status", and alert roles. Second, it uses a TreeWalker to examine text nodes for error-related text patterns, capturing error codes that may not be wrapped in typical error elements. The error extraction algorithm uses multiple pattern-matching strategies: HTTP status codes (100-599), common error code formats (ERR_*, E*, EXCEPTION_*, ERROR_*), Java exception names, and UUID-style error identifiers. Each detected error code is validated against known error code patterns to minimize false positives. The extension also captures surrounding context to help identify the error source. Each tracked error is assigned a unique ID based on the error code and context, ensuring that history stays correctly associated even when the same error appears in different contexts. A MutationObserver detects dynamic content updates and re-scans only when new error elements appear, balancing real-time accuracy with system performance.

THE PANEL – DRAG / PER-SITE POSITION / SNAP / COLLAPSE / RESIZE / ESCAPE

The error lookup panel includes a draggable title bar, allowing you to position it anywhere on screen for convenient access during debugging. The extension remembers your preferred position per website, so the panel opens in the same location each time you return to that domain. The panel supports snap-to-edge behavior – when dragged near screen edges, it gently snaps into place for a tidy workspace layout. You can collapse the panel down to just its title bar by clicking the collapse button, keeping it accessible without taking up screen space. The error list and history are contained within a scrollable body, ensuring all content remains accessible even on smaller screens. Pressing the Escape key closes the panel instantly, returning you to your debugging workflow.

PLEASE NOTE

This extension requires the free BotGentz extension to be installed and enabled, as it relies on BotGentz's userscript injection and GM_* API shims for cross-browser compatibility. Websites frequently update their HTML structures and class names, which may cause error detection to break temporarily – we actively maintain the matching patterns and release updates regularly. The extension stores all error data, resolution history, tags, and notes exclusively in your local browser storage (GM_setValue); no data is ever transmitted to any external server except when you manually perform an online lookup. Error lookups open in your default browser and are not tracked by the extension. You are responsible for backing up your error tracking data if you switch browsers or clear your storage. The extension does not read, modify, or interfere with any application functionality, error handling, or system behavior – it operates solely on the static page content and stores only metadata (error codes, messages, notes, and tags) that you explicitly create. Use this tool responsibly for internal debugging and error tracking purposes.