Documentation for automated readers
A curated documentation index is available at: https://grafana.com/llms.txt
A complete documentation index is available at: https://grafana.com/llms-full.txt
These indexes can help with page discovery before fetching individual documents.
This page is also available in Markdown, which may be easier for automated readers and AI tools to parse than HTML. The Markdown version is available at https://grafana.com/docs/k6/next/javascript-api/jslib/testing/retrying-assertions/tobedisabled.md, or by sending Accept: text/markdown to https://grafana.com/docs/k6/next/javascript-api/jslib/testing/retrying-assertions/tobedisabled/. For broader documentation discovery, the curated index is available at https://grafana.com/llms.txt and the complete index is available at https://grafana.com/llms-full.txt.
This is documentation for the next version of Grafana k6 documentation. For the latest stable release, go to the latest version.
toBeDisabled()
The toBeDisabled() method asserts that an element is disabled. This is a retrying assertion that automatically waits for the element to become disabled.
Syntax
await expect(locator).toBeDisabled();
await expect(locator).not.toBeDisabled();
await expect(locator).toBeDisabled(options);Parameters
| Parameter | Type | Description |
|---|---|---|
| options | RetryConfig | Optional configuration options |
Returns
| Type | Description |
|---|---|
| Promise | A promise that resolves when the assertion passes |
Description
The toBeDisabled() method checks if an element is disabled. An element is considered disabled if it has the disabled attribute or property set to true.
This is a retrying assertion that will automatically re-check the element’s disabled state until it becomes disabled or the timeout is reached.
Usage
import { browser } from 'k6/browser';
import { expect } from 'https://jslib.k6.io/k6-testing/0.6.1/index.js';
export const options = {
scenarios: {
ui: {
executor: 'shared-iterations',
options: {
browser: {
type: 'chromium',
},
},
},
}
};
export default async function () {
const page = await browser.newPage();
await page.goto('https://quickpizza.grafana.com/');
// Click the pizza button to see the recommendation
await page.locator('button[name="pizza-please"]').click();
// Wait for the recommendation to appear
await expect(page.locator('h2[id="pizza-name"]')).toBeVisible();
// The pizza button should now be disabled (no longer clickable)
await expect(page.locator('button[name="pizza-please"]')).toBeDisabled();
// Verify that we can check for disabled state
await expect(page.locator('button[name="pizza-please"]')).not.toBeEnabled();
}Was this page helpful?
Related resources from Grafana Labs

