Core Engineering Deep Dive

Engineered for Resilience: Zero-Flake Browser Automation

Traditional record-and-replay tools fail because they record brittle coordinates or fragile auto-generated CSS classes. Workflow Recorder replaces brittle heuristics with an intelligent multi-strategy DOM evaluation engine, event normalizers, and isolated content script pipelines.

Selector Engine & Gauge Event Pipeline Shadow DOM Piercing PrivacyGuard
Intelligent Targeting

The 7-Tier Resilient Selector Hierarchy

When you click or type, Workflow Recorder inspects the target DOM element across multiple candidate strategies, generating fallback tiers and scoring each candidate against uniqueness, DOM depth, and volatility penalties.

INTERACTIVE RESILIENCE GAUGE

Live Selector Scoring Studio

Evaluate test IDs, semantic locators, CSS classes, or XPath expressions against the real-time scoring algorithm.

100
/ 100 PTS
Rock Solid
Preset Selector Archetypes:
Hierarchy Tier
Tier 1 (Test ID)
DOM Uniqueness
Unique (1:1)
Fragility Penalty
0% (None)
Tier 1 Base: 1.00

Explicit Automation Anchors

Dedicated test attributes (data-testid, data-test, data-cy, data-qa) and static unique IDs. Never affected by design redesigns or styling class rewrites.

[data-testid="checkout-payment-btn"]
Tier 2 Base: 0.92

Accessible ARIA Semantics

Locators built on accessible user-facing contracts: aria-label, role + accessible text name, and associated <label for="..."> elements.

button[aria-label="Confirm Purchase"]
Tier 3 Base: 0.85

Stable Form Attributes

Form control attributes like name, input type, placeholder, and semantic class names with dynamic hashes pruned.

input[name="shipping_street"][type="text"]
Tier 4 Base: 0.70

Structural & Text XPath

Attribute-anchored and semantic text-anchored XPath expressions that uniquely identify elements containing specific text strings or nested structures.

//button[normalize-space()='Submit Review']
Tier 5 Base: 0.40

Ancestor-Scoped Hierarchies

Relative structural paths anchored to the nearest unique container element, avoiding full root-to-leaf paths that break on minor DOM layout shifts.

#checkout-summary > table > tr:nth-child(2) > td
Filter -45% Penalty

Dynamic Class Rejection

Automatically identifies and discards build-generated dynamic classes from CSS-in-JS (css-182jsd, sc-bdVaJa), Tailwind random hashes, GUIDs, and timestamps.

Discarded: btn-1726402800123 / sc-gzVnrw
Intelligent Filtering

Event Normalization & Noise Reduction

A real browser interaction produces thousands of raw micro-events every minute. Workflow Recorder's content-script normalizer groups, collapses, and cleans these events into high-level automated steps.

Keystroke Buffering & Grouping

Typing "admin@company.com" emits 34 raw events (keydown, keypress, input, keyup per character). The normalizer buffers typing into a pending character queue and flushes only 1 atomic input action when the user completes typing, navigates, or pauses for >800ms.

  • Eliminates bloated 1-character test steps
  • Preserves final form values cleanly
  • Flushes automatically on Enter or Tab keys

Scroll Debounce & Settling

Users scrolling down a lengthy product catalog generate dozens of wheel ticks per second. Workflow Recorder uses a 400ms debounce window that captures only the final settled viewport coordinates { x, y }.

  • Smooth 400ms stabilization window
  • Avoids viewport thrashing in test runs
  • Accurately triggers lazy-loaded elements

Redundant Click Suppression

Focusing an input field immediately followed by typing is merged cleanly into the input step. Accidental rapid double-clicks within 200ms are either deduplicated or promoted to explicit dblclick actions.

  • Focus-click merging on form inputs
  • Automatic double-click detection
  • Configurable hover threshold delay (500ms)
Micro-Frontend Ready

Shadow DOM & Multi-Frame Piercing

Modern enterprise applications use Web Components, closed Shadow Roots, and embedded iframes. Workflow Recorder captures cross-boundary event chains with complete encapsulation safety.

Closed Shadow DOM HUD Controller

The on-page floating recording bar is rendered inside a private <workflow-recorder-controller> Shadow DOM. All elements carry data-workflow-recorder-ignore so the recorder never records clicks on its own controls!

event.composedPath().some(el => el.hasAttribute('data-workflow-recorder-ignore'))

Multi-Level iFrame Locators

When interacting with elements inside embedded iframes (such as Stripe payment forms, OAuth popups, or chat widgets), the engine logs the frame hierarchy and generates Playwright page.frameLocator() syntax automatically.

page.frameLocator('#payment-iframe').locator('[data-testid="card-cvv"]')

Multi-Tab & Popup Tracking

When a link opens in a new tab or an SSO popup window appears, the background service worker maps Chrome tab IDs to logical keys (tab_1, tab_2), recording smooth tab switches and closures.

const popup = await page.waitForEvent('popup');
await popup.locator('#sso-confirm').click();
Security by Design

PrivacyGuard: Zero Telemetry & Sensitive Masking

Your credentials and enterprise data should never leave your machine. Workflow Recorder operates 100% client-side with automatic sanitization at the DOM event boundary.

Password Masking

Any input with type="password" is intercepted. Plaintext characters never enter memory or IndexedDB, immediately replaced with {{password}} tokens.

0 External Network Calls

No tracking pixels, no telemetry endpoints, no cloud accounts. Network call audit strictly proves 0 HTTP requests. Pure local client extension.

PII & Token Scrubber

Regex patterns automatically identify credit card numbers, CVVs, SSNs, OTP codes, and URL query tokens (e.g. ?access_token=...) and scrub them.

Local IndexedDB

Workflows and screenshots are saved in browser's local IndexedDB (workflow_recorder_db). Export, backup, or wipe all records with 1 click.

Experience the Intelligent Recording Engine

Add to Chrome in seconds and experience flake-free browser automation export.

Read Documentation & Guides