Playwright

Download 0
Last updated Sep 5, 2026

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

FieldTypeNameDescription
session_idStringSession ide.g. 6f1c2a08-6c1e-4a1b-9a5e-9b2f0d3c7e11
refStringElement refe.g. e45
credential_keyStringCredential keyThe key spent, never the value. e.g. login_name
targetStringTarget elementSnapshot line of the element acted on. e.g. - button "Save" [ref=e45]
resultStringResultWhat the server reported for the action. e.g. Ran Playwright code
errorStringErrorSet when the site refused the action, so the row arrives instead of the query failing. e.g. click blocked: another element covers this one
urlStringURL after actione.g. https://fw.example.com/policy/edit?id=12
titleStringPage title after actione.g. Edit policy - Firewall Console
element_countIntegerElement countAddressable elements on the screen the action landed on. e.g. 108
screenshot_guidStringScreenshot file guide.g. 3f2b8c10-5d4a-4e2f-8c7b-1a2b3c4d5e6f
screenshot_urlStringScreenshot URLServed inline, so an answer can embed it as ![caption](url). e.g. /files/3f2b8c10-5d4a-4e2f-8c7b-1a2b3c4d5e6f
sonar_urlStringFile store URLReadable by sonar-ai-ask-image. e.g. sonar://3f2b8c10-5d4a-4e2f-8c7b-1a2b3c4d5e6f
observationStringObservationAccessibility 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]