Browser

The Browser class in Ordino AI provides a suite of browser-level automation capabilities. It allows seamless interaction with browser windows, navigation, alerts, cookies, and more.

Usage : browser

🧩 Code

The Browser class is designed to interact with the browser

To insert a code block with syntax highlighting:

Cypress

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

oi.ui.browser().navigateToUrl('https://ordino.ai');

Playwright

Navigation Methods

navigateToUrl(url: string): void

Navigates to the specified URL.

• @param url – The URL to navigate to.

• @returns void

Cypress

oi.ui.browser().navigateToUrl('https://ordino.ai');

Playwright

refreshPage(): void

Refreshes the current page.

• @returns void

Cypress

oi.ui.browser().refreshPage('https://ordino.ai');

Playwright

goBack(): void

Navigates back to the previous page.

• @returns void

Cypress

oi.ui.browser().goBack();

Playwright

goForward(): void

Navigates forward to the next page.

• @returns void

Cypress

oi.ui.browser().goForward();

Playwright

getCurrentUrl(): Chainable<String>

Retrieves the current URL

• @returns object<promise>

Cypress

oi.ui.browser().getCurrentUrl().then((url) => {
  console.log('Current URL:', url);
});

Playwright

getPageTitle(): Chainable<String>

Retrieves the title of the current page.

• @returns object<promise>

Cypress

oi.ui.browser().getPageTitle().then((title) => {
  console.log('Page Title:', title);
});

Playwright

assertUrl(expectedUrl: <String>): void

Asserts that the current URL matches the specified URL.

• @param url – The URL to navigate to.

• @returns void

Cypress

oi.ui.browser().assertUrl('https://ordino.ai');

Playwright

assertPageTitle(expectedTitle: <String>): void

Asserts that the current page title matches the specified title.

• @param title – The title to assert

• @returns void

Cypress

oi.ui.browser().assertPageTitle('Ordino - Home');

Playwright

Browser Session & Storage

clearBrowserCache: void

Clears the browser cache.

• @returns void

Cypress

oi.ui.browser().clearBrowserCache();

Playwright

clearBrowserCookies: void

Clears the browser cookies.

• @returns void

Cypress

oi.ui.browser().clearBrowserCookies();

Playwright

setBrowserCookie(name: string, value: string): void

Sets a browser cookie with the specified name and value.

• @param name – The name of the cookie.

• @param value – The value of the cookie.

• @returns void

Cypress

oi.ui.browser().setBrowserCookie('sessionId', '12345');

Playwright

getBrowserCookies(): Chainable<Cookie[]>

Retrieves all browser cookies.

• @returns object<promise>

Cypress

oi.ui.browser().getBrowserCookies().then((cookies) => {
  console.log('Cookies:', cookies);
});

Playwright

Window & Frame Actions

setWindowSize(width: number, height: number): void

Sets the size of the browser window.

• @param width – The width of the window.

• @param height – The height of the window.

• @returns void

Cypress

oi.ui.browser().setWindowSize(1280, 720);

Playwright

switchToWindow(windowName: string): void

Switches to the specified window.

• @returns void

Cypress

oi.ui.browser().switchToWindow('newWindow');

Playwright

switchToFrame(frameName: any): void

Retrieves all browser cookies.

• @param frame-name - The name or index of the frame to switch to.

• @returns void

Cypress

ui.browser().switchToFrame('iframe-id');

Playwright

closeCurrentWindow(): void

Closes the current window.

• @returns void

Cypress

ui.browser().closeCurrentWindow();

Playwright

openNewTab(url: string): void

Opens a new tab with the specified URL.

• @param url - The url to open in the new tab.

• @returns void

Cypress

ui.browser().openNewTab('https://ordino.ai');

Playwright

assertBrowserIsOpen(): void

Asserts that the browser is open.

• @returns void

Cypress

ui.browser().oi.ui.browser.assertBrowserIsOpen();

Playwright

Screenshots & Alerts

takeScreenshot(fileName: string): void

Takes a screenshot and saves it with the specified file name.

• @param file-name - The name of the file to save the screenshot as

• @returns void

Cypress

ui.browser().takeScreenshot('homepage');

Playwright

takeFullPageScreenshot(fileName: string): void

Takes a full-page screenshot and saves it with the specified file name.

• @param frame-name - The name of the file to save the full-page screenshot as.

• @returns void

Cypress

ui.browser().takeFullPageScreenshot('full-homepage');

Playwright

handleAlert(alertText: string, action: string): void

Handles an alert with the specified text and action.

• @param alert-text - the text of the alert.

• @param action - The action to take on the alert (e.g., accept, dismiss).

• @returns void

Cypress

ui.browser().handleAlert('Confirm Delete?', 'accept');

Playwright

Network Handling

waitForNetworkIdle(): void

Waits for the network to be idle.

• @param frame-name - The name or index of the frame to switch to.

• @returns void

Cypress

ui.browser().waitForNetworkIdle();

Playwright