input

Type text into input fields with options to clear existing content and press Enter

Method Signature

await opensteer.input(options: InputOptions): Promise<ActionResult>

Types text into an input field or textarea. By default, clears existing content before typing.

Parameters

options · InputOptions · required

Configuration for the input action

Show InputOptions properties

text · string · required

The text to type into the input field.

description · string

Natural language description of the input element. Used for AI-powered element resolution when element or selector are not provided.

element · number

Counter number from snapshot HTML to identify the exact element.

selector · string

CSS selector to identify the input element.

clear · boolean · default: "true"

Whether to clear the existing content before typing. Set to false to append text.

pressEnter · boolean · default: "false"

Whether to press Enter after typing the text.

wait · false | ActionWaitOptions

Post-action wait configuration. Set to false to disable waiting, or provide options to customize wait behavior.

Returns

ActionResult · Promise<ActionResult>

Show ActionResult properties

method · string

The action method name (“input”)

namespace · string

The namespace identifier for this session

persisted · boolean

Whether the element path was successfully persisted for future use

pathFile · string | null

Path to the file where element path is stored

selectorUsed · string | null

The actual selector used to find the element

Examples

Basic Input

// Type into a field using AI-powered detection
await opensteer.input({
  description: 'Email address field',
  text: '[e-mail]'
})

Input with Selector

// Type using CSS selector
await opensteer.input({
  selector: '#username',
  text: 'john_doe',
  description: 'Username field'
})

Submit Form with Enter

// Type and press Enter to submit
await opensteer.input({
  description: 'Search box',
  text: 'OpenSteer documentation',
  pressEnter: true
})

Append Text

// Append to existing content without clearing
await opensteer.input({
  description: 'Message input',
  text: ' - additional text',
  clear: false
})

Input with Element Counter

// Use element counter from snapshot
await opensteer.input({
  element: 15,
  description: 'Password field',
  text: 'secure-password-123'
})

Multi-field Form

// Fill multiple form fields
await opensteer.input({
  description: 'First name',
  text: 'John'
})

await opensteer.input({
  description: 'Last name',
  text: 'Doe'
})

await opensteer.input({
  description: 'Email',
  text: '[e-mail]',
  pressEnter: true
})

Related methods

• click - Click on elements
• select - Select dropdown options
• file-upload - Upload files