Browser boundaries

Domstamp models boundaries explicitly so callers can distinguish “absent in the page” from “not available to this adapter.”

Current Playwright envelope

Boundary	Status	Representation
Light DOM	Supported	Elements, text, comments, attributes, paths, relationships
Template contents	Supported	A document-fragment below the template path
Open Shadow DOM	Supported	A shadow-root node and its descendants
Closed Shadow DOM	Opt-in instrumentation	Author-created roots observed by a pre-navigation preload, with per-frame provenance
Same-origin iframe	Supported	Independent DocumentSnapshot linked to its owner path
Cross-origin iframe	Supported	Independent document through Playwright’s frame execution boundary
Runtime form state	Supported	Values, checked/selected state, text selection
Geometry and styles	Supported	Bounding rectangles and configured computed properties
ARIA perception tree	Supported	Per-frame role, name, value, state, and parent graph from Playwright ARIA snapshots
Native OS accessibility tree	Unavailable	The current source is not an operating-system tree
Pixels	Supported	Hashed PNG/JPEG attachment with optional full-page/device scaling
Canvas/WebGL internals	Pixel evidence	DOM dimensions and an explicit pixel-layer marker; raster output is preserved only when pixels are enabled
CSS generated content	Supported where inspectable	::before and ::after content from accessible matching stylesheet rules
Browser chrome and extension UI	Out of scope	Not page DOM
JavaScript heap and closures	Out of scope	Not part of the snapshot schema

Iframes are included

Each captured browsing context becomes a document with a stable capture-local frameId. Child documents include parentFrameId and ownerPath, which points to the iframe element in the parent document.

Playwright can evaluate inside cross-origin frames through its automation protocol, so Domstamp does not rely on page JavaScript crossing the same-origin boundary.

const snapshot = await domstamp.capture(page, {
  features: {
    frames: { crossOrigin: true, maxFrames: 64 }
  }
});

Set frames: false to capture only the main document, or crossOrigin: false to retain same-origin children only.

Shadow-root policy

• none: do not traverse shadow roots.
• open: traverse roots available through element.shadowRoot.
• all-available: requires the adapter to advertise closed-shadow-roots in addition to open roots.

The default Playwright adapter rejects all-available; treating it as an alias for open would be misleading. An adapter constructed with a token from installClosedShadowInstrumentation(context) advertises closed-shadow-roots and labels the resulting coverage instrumented. Roots created before installation, user-agent roots, and hooks defeated by hostile page code remain outside that claim.

Driver differences

The Puppeteer adapter shares DOM, open-shadow, frame, layout, interaction, and mutation-consistency behavior. It does not advertise accessibility trees, pixels, or pixel redaction. Core structural redaction remains available because it is driver-independent.