Browser CapabilitiesInteraction

locator.fill

View as Markdown

locator.fill is a browser runtime capability in the locator namespace.

Availability

  • Runtime: browser
  • Kind: raw
  • Category: interaction
  • Supported drivers: Playwright, Puppeteer

SDK Surface

  • SDK path: runtime.page.locator(...).fill
  • Async: Yes

HTTP Surface

  • Transport: workspace.execute(...)
  • Call: locator.fill
  • Long-running: No

Reference Semantics

  • Requires refs: locator

Arguments

ArgumentTypeRequiredDescription
valuestringYesText to insert into the input.
optionsobjectNoDriver fill options.

Result

  • Type: void
  • Description: Resolves when the input value is updated.

SDK Example

1await runtime.page.locator('button[type=submit]').fill('hello');

HTTP Example

1{
2  "runtime": "crm",
3  "steps": [
4    {
5      "call": "locator.fill",
6      "args": [
7        "hello"
8      ]
9    }
10  ]
11}