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
await expect(locator).toHaveText(expected);
await expect(locator).not.toHaveText(expected);
await expect(locator).toHaveText(expected, options);Parameters
Options
This method accepts all RetryConfig properties plus:
Returns
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
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/');
// 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!');
}
