---
{
  "schemaVersion": 1,
  "operationType": "browser.element.input",
  "executorClass": "aivane.browser.executor.BrowserElementInputExecutor",
  "displayName": "Enter text",
  "description": "Enter text into the specified element",
  "category": "browser.element",
  "platforms": [
    "browser"
  ],
  "parameters": [
    {
      "name": "sessionId",
      "type": "string",
      "description": "Browser session ID; when empty, the current context session is used."
    },
    {
      "name": "ref",
      "type": "string",
      "description": "An element reference generated by browser.snapshot, such as @e1."
    },
    {
      "name": "selector",
      "type": "string",
      "description": "Selectors supported by CSS or Playwright."
    },
    {
      "name": "text",
      "type": "string",
      "description": "The text to be entered."
    },
    {
      "name": "value",
      "type": "string",
      "description": "Compatible alias for text.",
      "deprecated": true,
      "deprecatedMessage": "Please use the text parameter instead."
    },
    {
      "name": "clear",
      "type": [
        "boolean",
        "string"
      ],
      "default": true,
      "description": "Whether to clear the original value before inputting."
    },
    {
      "name": "useJs",
      "type": [
        "boolean",
        "string"
      ],
      "default": false,
      "description": "Whether to use JavaScript to assign values ​​directly; it is recommended to provide a selector when enabled."
    },
    {
      "name": "timeout",
      "type": [
        "integer",
        "string"
      ],
      "default": 30000,
      "description": "Enter the operation timeout in milliseconds."
    },
    {
      "name": "waitTimeout",
      "type": [
        "integer",
        "string"
      ],
      "default": 5000,
      "description": "Timeout to wait for an element to become editable."
    }
  ],
  "constraints": {
    "oneOfRequired": [
      "ref",
      "selector"
    ]
  }
}
---

# browser.element.input
