playwright-login
Fills one sign-in field of an open browser session with a value the session's credential profile holds, and returns the screen afterwards.
Name the key and the value is looked up on the way to the browser, so an account or a password never appears in the query, the query log, or the row - which records the key that was spent, never its value. The keys the profile carries are listed as credential_keys by playwright-open.
Fill one field per call, reading the screen to see which field wants which key: sign-in screens differ too much to be filled in advance. Submit with playwright-click on the button, or playwright-press key="Enter".
A read-only session allows this, since signing in is how it reaches the pages it may read.
playwright-login session-id=VALUE ref=VALUE key=VALUE [screenshot=VALUE]
- session-id=VALUE
- Required. Browser session to sign in to. e.g. the session_id returned by playwright-open
- ref=VALUE
- Required. Element to fill, named by a ref from the last observation. Every reading reassigns refs, so take it from the most recent one. e.g. e45
- key=VALUE
- Required. Names the value to fill without passing it: login_name, password or otp, whichever the profile carries. e.g. login_name
- screenshot=VALUE
- Optional. Store a screenshot of the resulting screen. t by default. e.g. f
Output Fields
| Field | Type | Name | Description |
|---|---|---|---|
| session_id | String | Session id | e.g. 6f1c2a08-6c1e-4a1b-9a5e-9b2f0d3c7e11 |
| ref | String | Element ref | e.g. e45 |
| credential_key | String | Credential key | The key spent, never the value. e.g. login_name |
| target | String | Target element | Snapshot line of the element acted on. e.g. - button "Save" [ref=e45] |
| result | String | Result | What the server reported for the action. e.g. Ran Playwright code |
| error | String | Error | Set when the site refused the action, so the row arrives instead of the query failing. e.g. click blocked: another element covers this one |
| url | String | URL after action | e.g. https://fw.example.com/policy/edit?id=12 |
| title | String | Page title after action | e.g. Edit policy - Firewall Console |
| element_count | Integer | Element count | Addressable elements on the screen the action landed on. e.g. 108 |
| screenshot_guid | String | Screenshot file guid | e.g. 3f2b8c10-5d4a-4e2f-8c7b-1a2b3c4d5e6f |
| screenshot_url | String | Screenshot URL | Served inline, so an answer can embed it as . e.g. /files/3f2b8c10-5d4a-4e2f-8c7b-1a2b3c4d5e6f |
| sonar_url | String | File store URL | Readable by sonar-ai-ask-image. e.g. sonar://3f2b8c10-5d4a-4e2f-8c7b-1a2b3c4d5e6f |
| observation | String | Observation | Accessibility snapshot of the screen after the action, with fresh refs - act on one of these rather than observing again. e.g. - button "Save" [ref=e45] |