ARIA Attribute Auditor

WHAT IT DOES

ARIA Attribute Auditor scans the current webpage for all ARIA attributes including role, aria-label, aria-labelledby, aria-describedby, aria-hidden, aria-expanded, aria-controls, aria-live, aria-atomic, aria-relevant, aria-modal, and over 25 others. It generates a real-time summary showing total ARIA attributes found, distinct elements with ARIA, and a breakdown by attribute type. Every element with ARIA attributes is listed with its tag name, CSS selector path, and complete set of attribute name-value pairs. The tool highlights elements with missing required ARIA attributes (e.g., role without required children), potentially incorrect values (e.g., invalid role values), and common misuse patterns like aria-hidden on focusable elements. A dedicated warnings section aggregates issues by severity so you can prioritize fixes.

WHERE IT RUNS

The auditor operates as a browser extension overlay panel that works on any standard web page including SPAs, iframes, shadow DOM, and dynamically generated content. It attaches to the page's document object model and listens for mutations so the audit updates automatically when the page changes. The extension runs entirely client-side with no data sent to any server. It works on HTTP and HTTPS pages and respects the page's Content Security Policy.

HOW TO USE

Install the BotGentz free extension first, then install ARIA Attribute Auditor. Click the extension toolbar icon to open the panel or use the keyboard shortcut Ctrl+Shift+A (Cmd+Shift+A on Mac). The panel appears as a draggable overlay. Toggle the audit on/off with the power switch at the top of the panel. When active, the panel scans the page and populates the results. Click any element listing to scroll to and highlight that element in the page. Use the filter input to narrow the list by element tag, attribute name, or value. The summary section updates live as you filter. Close the panel with the × button or press the Escape key. All settings including panel position, collapsed state, and audit on/off status are saved per site using localStorage and persist across browser sessions.

HOW THE SELECTOR ENGINE WORKS

Unlike tools that rely on XPath or full CSS selectors that break with minor DOM changes, ARIA Attribute Auditor generates resilience-selectors using a stable fingerprinting technique. For each element, the engine records its tag, id (if present), a truncated set of class names ordered by specificity, and positional indices only within immediate siblings of the same tag. When reconstructing the selector path, the engine prefers id-based lookup, then unique class combinations, then falls back to a robust path that remains valid through most dynamic updates. This mechanism enables the auditor to maintain stable references to elements even when the page's structure shifts through virtual DOM rendering, because the fingerprinting remains anchored to persistent attributes rather than volatile DOM positions.

THE PANEL

The overlay panel is fully draggable by its title bar and snaps to the nearest edge of the browser viewport when released. It remembers its position per site. A collapse toggle in the header reduces the panel to a compact title-only bar, and the panel expands back when clicked. The results area is independently scrollable and resizeable by dragging the bottom-right corner. The panel also supports keyboard navigation—Tab moves focus through controls and results, Enter expands element details, and Escape closes the panel entirely.

PLEASE NOTE

This extension requires the free BotGentz base extension to be installed and enabled. BotGentz provides the core messaging, storage, and permissions framework; ARIA Attribute Auditor operates as a module within that ecosystem. Web pages and their underlying scripts change frequently—if the auditor fails to detect certain attributes, the page's framework may have modified the DOM in ways that require a script update, which we publish regularly. The extension does not collect, store, or transmit any personal data, browsing history, or page content. All audit data exists only in your browser's memory and localStorage for settings. No analytics, no telemetry, no tracking.