TextBox

The TextBox class provides a streamlined interface for interacting with text input fields. It includes methods for typing, asserting values, and scrolling elements into view. These capabilities improv

Usage : textbox

🧩 Code

The Textbox class is designed to interact with common textbox element

To insert a code block with syntax highlighting:

Cypress

import { oi } from "@ordino.ai/spartify-engine";

oi.ui.textbox(this.txt_element).enterText(text)

Playwright

Methods

enterText(text: string): void

Enters the specified text into the textbox.

• @returns void

Cypress

oi.ui.textbox(this.txt_element).enterText(text)

Playwright

clickAndType(text: string, forceClick:boolean): void

Clicks on the textbox and types the given text.

• @param text – The text to type.

• @returns void

Cypress

oi.ui.textbox(this.txt_element).clickAndType(text)

Playwright

clearText(): void

Clears the text from the textbox.

• @returns void

Cypress

oi.ui.textbox(this.txt_element).clearText()

Playwright

typeInAll(text: string): void

Types the specified text in all instances of the textbox.

• @param text – The text to type.

• @returns void

Cypress

oi.ui.textbox(this.txt_element).typeInAll(text)

Playwright

clickAndTypeFirst(text: string, forceClick:boolean): void

Clicks on the first instance of the textbox and types the given text.

• @param text – The text to type.

• @returns void

Cypress

oi.ui.textbox(this.txt_element).clickAndTypeFirst(text)

Playwright

clickAndTypeLast(text: string, forceClick:boolean): void

Clicks on the last instance of the textbox and types the given text.

• @param text – The text to type.

• @returns void

Cypress

oi.ui.textbox(this.txt_element).clickAndTypeLast(text)

Playwright

typeAndPressEnter(text: string): void

Types the specified text and presses Enter.

• @param text – The text to type.

• @returns void

Cypress

oi.ui.textbox(this.txt_element).typeAndPressEnter(text)

Playwright

typeSlowly(text: string): void

Types the specified text slowly.

• @param text – The text to type.

• @returns void

Cypress

oi.ui.textbox(this.txt_element).typeSlowly(text)

Playwright

appendText(text: string): void

Appends the specified text to the existing text in the textbox.

• @param text – The text to append.

• @returns void

Cypress

oi.ui.textbox(this.txt_element).appendText(text)

Playwright

clearAndType(text: string): void

Clears the existing text and types the specified text.

• @param text – The text to type.

• @returns void

Cypress

oi.ui.textbox(this.txt_element).clearAndType(text)

Playwright

Assertions

assertPlaceholder(text: string): void

Asserts that the placeholder text of the textbox matches the specified text.

• @param text – The expected placeholder text.

• @returns void

Cypress

oi.ui.textbox(this.txt_element).assertPlaceholder(text)

Playwright

assertMaxLength(length: number): void

Asserts that the maximum length of the textbox is equal to the specified length.

• @param length – The expected maximum length.

• @returns void

Cypress

oi.ui.textbox(this.txt_element).assertMaxLength(length)

Playwright

assertIsEmpty(): void

Asserts that the textbox is empty.

• @returns void

Cypress

oi.ui.textbox(this.txt_element).assertIsEmpty()

Playwright

assertIsNotEmpty(): void

Asserts that the textbox is not empty.

• @returns void

Cypress

oi.ui.textbox(this.txt_element).assertIsNotEmpty()

Playwright

assertTextAlignment(alignment: string): void

Asserts that the text alignment of the textbox matches the specified alignment.

• @param alignment – The expected text alignment.

• @returns void

Cypress

oi.ui.textbox(this.txt_element).assertTextAlignment(alignment)

Playwright

assertCssProperty(property: string, value: string): void

Asserts that the specified CSS property of the textbox matches the expected value.

• @param property – The CSS property to check.

• @returns void

Cypress

oi.ui.textbox(this.txt_element).assertCssProperty(property, value)

Playwright

Scrolling Actions

scrollToElement(): void

Scrolls to the textbox element.

• @returns void

Cypress

oi.ui.textbox(this.btn_element).scrollToElement()

Playwright

Custom Events

Ordino allows you to build custom actions or user journeys by directly interacting with the underlying tool’s native methods and actions.

This approach gives you full control, bypassing Ordino’s abstraction layer, and ensures you can leverage tool-specific capabilities as needed.

• locator → The element locator (e.g., XPath, CSS selector, or tool-specific reference).

• Returns → A tool element object on which you can invoke native actions (e.g., .click(), .type()).

// Generic pattern
element(locator): object

_{Ordino Custom Mode}

Using Ordino’s direct tool method reference:

// Ordino direct-to-tool approach
oi.ui.element('@xpath').click()

Here, Ordino will call the Cypress (or other tool) element object directly, rather than going through Ordino’s wrapper.

Building User Journeys

By chaining multiple oi.ui.element() calls, you can construct full user journeys while still working with native tool methods.

Example: Login Flow

// Enter username
oi.ui.element('//input[@id="username"]').type('testuser')

// Enter password
oi.ui.element('//input[@id="password"]').type('secret')

// Click login button
oi.ui.element('(//*[contains(text(),"Login")])[1]').click()

---

Key Notes

• Use this mode when you need maximum control over the test framework.

• This does not abstract or transform the call – it executes directly on the tool object (e.g., Cypress, Playwright, etc.).

• Perfect for custom journeys, advanced locators, or tool-specific actions not exposed by Ordino’s higher-level API.