Skip to content

PageAssertions ​

Added in: v1.17

The PageAssertions class provides assertion methods that can be used to make assertions about the Page state in the tests.

csharp
using System.Text.RegularExpressions;
using Microsoft.Playwright;
using Microsoft.Playwright.MSTest;

namespace PlaywrightTests;

[TestClass]
public class ExampleTests : PageTest
{
    [TestMethod]
    public async Task NavigateToLoginPage()
    {
        await Page.GetByRole(AriaRole.Button, new() { Name = "Sign In" }).ClickAsync();
        await Expect(Page).ToHaveURLAsync(new Regex(".*/login"));
    }
}

Methods ​

PageAssertions.ToHaveTitleAsync() ​

Added in: v1.20

Ensures the page has the given title.

Usage

csharp
await Expect(Page).ToHaveTitleAsync("Playwright");

Arguments

  • titleOrRegExp string | RegExp Added in: v1.18

    Expected title or RegExp.

  • options Object (optional)

    • timeout float (optional) Added in: v1.18

      Time to retry the assertion for in milliseconds. Defaults to 5000.

PageAssertions.ToHaveURLAsync() ​

Added in: v1.20

Ensures the page is navigated to the given URL.

Usage

csharp
await Expect(Page).ToHaveURLAsync(new Regex(".*checkout"));

Arguments

  • urlOrRegExp string | RegExp Added in: v1.18

    Expected URL string or RegExp.

  • options Object (optional)

    • ignoreCase boolean (optional) Added in: v1.44

      Whether to perform case-insensitive match. ignoreCase option takes precedence over the corresponding regular expression parameter if specified. A provided predicate ignores this flag.

    • timeout float (optional) Added in: v1.18

      Time to retry the assertion for in milliseconds. Defaults to 5000.

PageAssertions.ToMatchAriaSnapshotAsync() ​

Added in: v1.60

Asserts that the page body matches the given accessibility snapshot.

Usage

csharp
await page.GotoAsync("https://demo.playwright.dev/todomvc/");
await Expect(page).ToMatchAriaSnapshotAsync(@"
  - heading ""todos""
  - textbox ""What needs to be done?""
");

Arguments

  • expected string

  • options Object (optional)

    • timeout float (optional)

      Time to retry the assertion for in milliseconds. Defaults to 5000.

Properties ​

PageAssertions.Not ​

Added in: v1.20

Makes the assertion check for the opposite condition.

Usage

For example, this code tests that the page URL doesn't contain "error":

csharp
await Expect(Page).Not.ToHaveURLAsync("error");

Type

  • PageAssertions

Released under the Apache 2.0 License.