Back to docs

Tool Type Text

Category: Browser Automation · Tier: Free

Type text character by character using keyboard events. Unlike fill, this fires keydown/keypress/keyup for each character. Use for inputs that need real keyboard events (autocomplete, search-as-you-type, games).

Parameters

Parameter Type Required Default Description
text string Yes — Text to type
delay number No 50 Delay between keystrokes in ms. 0 types with no delay
force boolean No - Type even when a newline or space in the text would activate a red-zone control
_browserToken string No — Browser session token

On success the response is { "success": true, "typed": "<text>", "characters": <n> }.

Red-zone refusal

A newline in the text is Enter, so "4242\n" in a card field can submit a checkout form. When a newline or space would activate a red-zone control, the call is refused unless force is true, the same gate as press_key. The response is a tool error (isError: true) with success: false, tool: "type_text", zone: "red", typed: null, the gate's message, and howToRun naming force: true. On the hosted server a refused call is refunded.

When to Use type_text vs fill

  • fill -- Sets the value instantly. Fast. Works for most forms. No per-keystroke events.
  • type_text -- Types character by character. Fires all keyboard events. Required for autocomplete, search suggestions, live validation, games.

Example

Type "react hooks" into the search bar to trigger autocomplete suggestions

From the Blog