Menu
Open source

toHaveText()

The toHaveText() method asserts that an element has specific text content. This is a retrying assertion that automatically waits for the element to have the expected text.

Syntax

JavaScript
await expect(locator).toHaveText(expected);
await expect(locator).not.toHaveText(expected);
await expect(locator).toHaveText(expected, options);

Parameters

ParameterTypeDescription
expectedstring | RegExp | ArrayThe expected text content
optionsobjectOptional configuration options

Options

This method accepts all RetryConfig properties plus:

PropertyTypeDefaultDescription
useInnerTextbooleanfalseUse innerText instead of textContent

Returns

TypeDescription
PromiseA promise that resolves when the assertion passes

Description

The toHaveText() method checks if an element has specific text content. By default, it uses textContent which includes all text nodes, including hidden ones. When useInnerText is true, it uses innerText which only includes visible text.

This is a retrying assertion that will automatically re-check the element’s text content until it matches the expected value or the timeout is reached.

Usage

JavaScript
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/');

  // Check exact text content
  await expect(page.locator('h1')).toHaveText('Looking to break out of your pizza routine?');

  // Click the pizza button to get a recommendation
  await page.locator('button[name="pizza-please"]').click();

  // Check the recommendation header text
  await expect(page.locator('h2')).toHaveText('QuickPizza has your back!');
}