devtools_recorder

Record and replay browser actions.

Record and replay browser actions. start records every browser_navigate/click/fill/select/key/wait on the tab (with a stable selector per element); stop saves the flow as a JSON artifact. add_assertion appends a browser_wait check; add_checkpoint marks a place replay can stop at; parameterize turns a recorded literal into {{name}}. replay runs a flow on a tab with params, resolving selectors to fresh refs, and stops at the first failure or at stopAtCheckpoint.

Parameters

action · enum · required

One of: start, stop, status, list, get, add_assertion, add_checkpoint, parameterize, replay, delete_step, export.

format · enum

export: target format (Playwright TypeScript test) One of: playwright.

path · string

export: also write the file here

tabId · integer

Target tab id from browser_tabs, which lists tabs across all windows. Defaults to the agent’s most recently opened usable tab, or the only usable tab. Otherwise select a listed tabId.

name · string

 

flowId · string

Flow id or artifact path

assertion · object

 

label · string

Checkpoint label

stepIndex · integer

 

field · string

Arg to parameterize, e.g. “text” or “url”

paramName · string

 

params · object

 

stopAtCheckpoint · string

 

fromStep · integer

 

continueOnFailure · boolean

 

Example

{
  "action": "start",
  "tabId": 1234,
  "name": "checkout"
}

Add an assertion while recording

{
  "action": "add_assertion",
  "flowId": "checkout",
  "assertion": {
    "text": "Order confirmed"
  }
}

{
  "action": "stop",
  "flowId": "checkout"
}

Turn a literal into a parameter

{
  "action": "parameterize",
  "flowId": "checkout",
  "stepIndex": 2,
  "field": "text",
  "paramName": "email"
}

Replay with parameters

{
  "action": "replay",
  "flowId": "checkout",
  "tabId": 1234,
  "params": {
    "email": "[e-mail]"
  }
}

Export as a Playwright test

{
  "action": "export",
  "flowId": "checkout",
  "format": "playwright",
  "path": "/Users/me/tests/checkout.spec.ts"
}