This library provides utility matchers for Jest in combination with Playwright. All of them are exposed on the expect object. You can use them either directly or invert them via the .not property like shown in a example below.

npm install -D expect-playwright playwright-core

To activate it in your Jest environment you have to include it in your configuration.

{
    "setupFilesAfterEnv": ["expect-playwright"]
}

import expect from "expect-playwright"

await expect(page).toHaveText("#foo", "my text")

The Playwright API is great, but it is low level and not designed for integration testing. So this package tries to provide a bunch of utility functions to perform the common checks easier.

Example which should wait and compare the text content of a paragraph on the page.

// before
await page.waitForSelector("#foo")
const textContent = await page.$eval("#foo", el => el.textContent)
expect(textContent).stringContaining("my text")

// after by using expect-playwright
await expect(page).toHaveText("#foo", "my text")

• toHaveSelector
• toHaveSelectorCount
• toHaveText
• toEqualText
• toEqualValue
• toEqualUrl
• toHaveFocus

expect(page: Page).toHaveSelector(selector: string, options?: PageWaitForSelectorOptions)

This function waits as a maximum as the timeout exceeds for a given selector once it appears on the page.

await expect(page).toHaveSelector("#foobar")
// or via not, useful to only wait 1 second instead of for the default timeout by Playwright which is 30 seconds.
await expect(page).not.toHaveSelector("#foobar", {
  timeout: 1 * 1000
})

expect(page: Page).toHaveFocus(selector: string, options?: PageWaitForSelectorOptions)

This function checks if the given selector has focus.

await expect(page).toHaveFocus("#foobar")
// or via not, useful to only wait 1 second instead of for the default timeout by Playwright which is 30 seconds.
await expect(page).not.toHaveFocus("#foobar", {
  timeout: 1 * 1000
})

expect(page: Page).toHaveSelector(value: string)

This function checks if the given URL matches the current page's URL

await expect(page).toEqualUrl("https://github.com")

expect(page: Page).toHaveSelector(selector: string, value: number, options?: PageWaitForSelectorOptions)

This function checks if the count of a given selector is the same as the provided value.

await expect(page).toHaveSelectorCount(".my-element", 3)

This function checks if the textContent of a given element contains the provided value.

You can do this via a selector on the whole page:

expect(page: Page).toHaveText(selector: string, value: string, options?: PageWaitForSelectorOptions)

await expect(page).toHaveText("#my-element", "MyValue")

Or without a selector which will use the body element:

expect(page: Page).toHaveText(value: string)

await expect(page).toHaveText("Playwright")

Or by passing a Playwright ElementHandle:

expect(element: ElementHandle).toHaveText(value: string)

const element = await page.$('#my-element');
await expect(element).toHaveText("Playwright")

This function checks if the textContent of a given element is the same as the provided value.

You can do this via a selector on the whole page:

expect(page: Page).toEqualText(selector: string, value: string, options?: PageWaitForSelectorOptions)

await expect(page).toEqualText("#my-element", "Playwright")

Or without a selector which will use the body element:

expect(page: Page).toEqualText(value: string, options?: PageWaitForSelectorOptions)

await expect(page).toEqualText("Playwright")

Or by passing a Playwright ElementHandle:

expect(element: ElementHandle).toEqualText(value: string, options?: PageWaitForSelectorOptions)

const element = await page.$('#my-element');
await expect(element).toEqualText("Playwright")

This function checks if the value of a given element is the same as the provided value.

You can do this via a selector or the element directly:

expect(page: Page).toEqualValue(selector: string, value: string, options?: PageWaitForSelectorOptions)

await expect(page).toEqualValue("#my-element", "Playwright")

Or by passing a Playwright ElementHandle:

expect(element: ElementHandle).toEqualValue(value: string, options?: PageWaitForSelectorOptions)

const element = await page.$('#my-element');
await expect(element).toEqualValue("Playwright")

import playwright from 'playwright-chromium'

describe("GitHub Playwright project", () => {
  it("should should have Playwright in the README heading", async () => {
    const browser = await playwright.chromium.launch()
    const page = await browser.newPage()
    await page.goto("https://github.com/microsoft/playwright")
    await expect(page).toHaveText("#readme h1", "Playwright")
    // or also all of them via the not property
    await expect(page).not.toHaveText("this-is-no-anywhere", { timeout: 1 * 1000 })
    await browser.close()
  })
})

There are typings available. For that just import

import "expect-playwright"

at the top of your test file or include it globally in your tsconfig.json.

• expect-puppeteer