Tab Memory Usage Badge

WHAT IT DOES

Tab Memory Usage Badge shows you exactly how much memory your current tab is using, displayed as a clean badge in the corner of your screen. The extension uses the Performance API's `performance.memory` property (where available) to estimate the tab's memory consumption, showing the total memory used in MB or GB. A detailed breakdown panel provides a per-resource view of memory usage, including JavaScript heap size, DOM size, and estimated memory used by scripts, stylesheets, and images. The badge updates in real-time as the page changes, and you can set a memory threshold that triggers a visual alert when the tab exceeds it. This is an invaluable tool for developers debugging memory leaks, QA engineers testing performance, and anyone who wants to monitor resource usage of web applications.

WHERE IT RUNS

The extension works on every website with the Performance API available, including complex single-page applications, traditional websites, and any page with JavaScript execution. It runs locally in your browser, reading memory metrics from the browser's performance API without sending any data to external servers. The extension supports all major browsers and adapts to both desktop and mobile viewports seamlessly.

HOW TO USE

After installation, a memory badge appears in the bottom-right corner of the page showing the current memory usage (e.g., "45 MB"). Click the badge to open a detailed breakdown panel showing memory usage by resource type. The panel displays JavaScript heap usage, DOM size, and estimated memory for scripts, stylesheets, and images with percentages. To customize the experience, open the extension panel and toggle "Show memory badge" to show or hide the badge. Toggle "Show detailed breakdown" to control the detail level in the panel. Set a memory threshold (50-2000 MB) to receive alerts when memory usage exceeds the limit. Adjust the update interval from 2 to 60 seconds to control how often the badge refreshes. For per-site customization, set a unique threshold for specific websites using the per-site controls.

THE ACTUAL MECHANISM — PERFORMANCE API WITH RESOURCE ESTIMATION AND REAL-TIME UPDATES

The extension uses the `performance.memory` API (`usedJSHeapSize`, `totalJSHeapSize`, `jsHeapSizeLimit`) to get accurate JavaScript heap memory usage from the browser. When the API is available, the total memory value is taken directly from `usedJSHeapSize`. For browsers that do not support `performance.memory`, the extension falls back to estimating memory usage by measuring the DOM size (using `Blob` size of the outerHTML) and estimating resource sizes based on element counts (scripts, stylesheets, images). The breakdown panel shows the JavaScript heap size, DOM size, and estimated sizes for scripts, stylesheets, and images. The badge updates at a user-defined interval (default: 5 seconds) using `setInterval`. When the memory usage exceeds the configured threshold, a notification appears at the bottom-right of the screen. The badge is color-coded: green (under 50% of threshold), orange (50-100%), and red (over threshold). Per-site thresholds and enabled states are stored using GM_setValue with domain-specific keys.

THE PANEL

The settings panel is a lightweight, draggable overlay that appears in the center of your screen. You can reposition it by clicking and dragging the title bar; release it near the screen edge and it will snap into place automatically. To collapse the panel into a compact title bar, click the minimize button, expanding it again with the same control. The panel is fully responsive, adapting to different screen resolutions with a minimum width of 300px and a maximum of 480px. Press the Escape key at any time to dismiss the panel without applying changes. All controls—the enable/disable toggle, refresh button, show details button, badge toggle, breakdown toggle, threshold input, update interval selector, per-site threshold override, and per-site enable/disable controls—are accessible within a clean, high-contrast interface that respects your system's color scheme.

PLEASE NOTE

This extension requires the free BotGentz companion extension to be installed and active, which provides the underlying DOM access and storage engine. Memory usage is estimated using the `performance.memory` API, which is not available in all browsers (currently supported in Chromium-based browsers). For browsers without this API, the extension falls back to estimation methods that may not be accurate. The breakdown estimates are approximations and should not be considered precise measurements. Threshold alerts are designed for monitoring and debugging—they do not automatically suspend or close tabs. No personal data, browsing history, or memory usage data is ever collected, stored, or transmitted. All settings are saved using the browser's storage API and remain solely on your device. The extension does not inject ads, trackers, or analytics of any kind.