traces.ribdsp.com

read_dom_at

Read the state of the recorded page at one moment as a compact, indented list of the interactive and state-bearing elements: form values, disabled and required flags, aria state, option counts, error text. This is not HTML — layout wrappers, classes and styling are dropped, and the output is capped at 60 lines / 1200 characters. Use it once you know which moment matters (from list_events or bisect); pass "scope" to zoom into one container when the whole page is too broad. It cannot tell you where things are on screen or what covers what — that is measure_layout.

Input schema

{
  "type": "object",
  "properties": {
    "timestamp": {
      "type": "number",
      "description": "The moment to read, in ms from the start of the recording. Example: 28412 for 28.412 seconds in. Must be between 0 and durationMs from read_session_meta."
    },
    "scope": {
      "type": "string",
      "description": "Optional CSS selector for a container to read instead of the whole page, e.g. \"#checkout\" or \"form[name=payment]\". Use this when the full-page read comes back truncated."
    }
  },
  "required": [
    "timestamp"
  ],
  "additionalProperties": false
}