ivya is a fork of Playwright's locator resolution. It is only available in the browser or browser-like environments.
Supports all Playwright selectors
Supports Shadow DOM
CSS and Xpath support out of the box
TypeScript support
getBy* selectors helpers
Locator generator support
import { Ivya, getByRoleSelector } from 'ivya'// Ivya is a singleton, so it will always return the same instanceconst ivya = Ivya.create({ browser: 'chromium', testIdAttribute: 'data-test-id',})// using locator selector (a string)const element = ivya.queryLocatorSelector( getByRoleSelector('button', { name: 'Click Me!' }))// using a wrapper functionconst element = ivya.queryByRole('button', { name: 'Click Me!' })const elements = ivya.queryAllByRole('button', { name: 'Click Me!' })// using Playwright selectorsconst element = ivya.queryLocatorSelector('text=Click Me!')const element = ivya.queryLocatorSelector('css=button[data-click]')// using parsed selector (good for caching)const selector = ivya.parseSelector( getByRoleSelector('button', { name: 'Click Me!' }))const elements = ivya.querySelector(selector, document.body, false)
Supported methods
All query methods follow the same rules described in the Playwright documentation, but return an HTML element instead of a locator.
ivya.queryByRole(name: string, options?: ByRoleOptions): Element | null