This is documentation for the next version of Grafana k6 documentation. For the latest stable release, go to the latest version.

Documentation

toBeEmpty()

Open source

toBeEmpty()

The toBeEmpty() method asserts that an element is empty. It automatically retries the assertion until the element becomes empty or the timeout is reached.

Syntax

await expect(locator).toBeEmpty();
await expect(locator).not.toBeEmpty();
await expect(locator).toBeEmpty(options);

Parameters

Parameter	Type	Description
options	RetryConfig	Optional configuration options

Returns

Type	Description
Promise	A promise that resolves when the assertion passes

Description

The toBeEmpty() method checks if an element is empty. An element is considered empty if:

For input elements: the value is an empty string ("")
For other elements: the text content is empty (no visible text)

This method automatically retries the assertion until the element’s content becomes empty 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();
  await page.goto('https://quickpizza.grafana.com/');

  // Click on the advanced checkbox
  await page.locator('label div').click();

  // Check that an input field is empty
  await expect(page.locator('#pizza-name')).toBeEmpty();

  // Fill input and then verify it's not empty
  await page.locator('#pizza-name').fill('my pizza');
  await expect(page.locator('#pizza-name')).not.toBeEmpty();
}