Menu
Open source
toBeEditable()
The toBeEditable() method asserts that an element is editable. This is a retrying assertion that automatically waits for the element to become editable.
Syntax
await expect(locator).toBeEditable();
await expect(locator).not.toBeEditable();
await expect(locator).toBeEditable(options);Parameters
| Parameter | Type | Description |
|---|---|---|
| options | RetryConfig | Optional configuration options |
Returns
| Type | Description |
|---|---|
| Promise | A promise that resolves when the assertion passes |
Description
The toBeEditable() method checks if an element is editable. An element is considered editable if it can receive user input. This includes:
- Input fields that are not disabled or readonly
- Textareas that are not disabled or readonly
- Elements with
contenteditable="true"
This is a retrying assertion that will automatically re-check the element’s editable state until it becomes editable or the timeout is reached.
Usage
import { browser } from 'k6/browser';
import { expect } from 'https://jslib.k6.io/k6-testing/0.5.0/index.js';
export const options = {
scenarios: {
ui: {
executor: 'shared-iterations',
options: {
browser: {
type: 'chromium',
},
},
},
}
};
export default async function () {
const page = await browser.newPage();
// Go to a test page that demonstrates editable functionality
await page.goto('https://quickpizza.grafana.com/login');
// Check that input fields are editable
await expect(page.locator('#username')).toBeEditable();
await expect(page.locator('#password')).toBeEditable();
await expect(page.locator('#message')).toBeEditable();
// Check readonly field is not editable
await expect(page.locator('#readonly-field')).not.toBeEditable();
// Check contenteditable elements
await expect(page.locator('[contenteditable="true"]')).toBeEditable();
await expect(page.locator('[contenteditable="false"]')).not.toBeEditable();
}