class: APIResponseAssertions

• since: v1.18

The [APIResponseAssertions] class provides assertion methods that can be used to make assertions about the [APIResponse] in the tests.

import { test, expect } from '@playwright/test';

test('navigates to login', async ({ page }) => {
  // ...
  const response = await page.request.get('https://playwright.dev');
  await expect(response).toBeOK();
});

// ...
import static com.microsoft.playwright.assertions.PlaywrightAssertions.assertThat;

public class TestPage {
  // ...
  @Test
  void navigatesToLoginPage() {
    // ...
    APIResponse response = page.request().get("https://playwright.dev");
    assertThat(response).isOK();
  }
}

from playwright.async_api import Page, expect

async def test_navigates_to_login_page(page: Page) -> None:
    # ..
    response = await page.request.get('https://playwright.dev')
    await expect(response).to_be_ok()

from playwright.sync_api import Page, expect

def test_navigates_to_login_page(page: Page) -> None:
    # ..
    response = page.request.get('https://playwright.dev')
    expect(response).to_be_ok()

using Microsoft.Playwright;
using Microsoft.Playwright.MSTest;

namespace PlaywrightTests;

[TestClass]
public class ExampleTests : PageTest
{
    [TestMethod]
    public async Task NavigatesToLoginPage()
    {
        var response = await Page.APIRequest.GetAsync("https://playwright.dev");
        await Expect(response).ToBeOKAsync();
    }
}

property: APIResponseAssertions.not

• since: v1.20
• langs: java, js, csharp

• returns: <[APIResponseAssertions]>

Makes the assertion check for the opposite condition.

Usage

For example, this code tests that the response status is not successful:

await expect(response).not.toBeOK();

assertThat(response).not().isOK();

await Expect(response).Not.ToBeOKAsync();

async method: APIResponseAssertions.NotToBeOK

• since: v1.19
• langs: python

The opposite of [method: APIResponseAssertions.toBeOK].

async method: APIResponseAssertions.toBeOK

• since: v1.18
• langs:
  • alias-java: isOK

Ensures the response status code is within 200..299 range.

Usage

await expect(response).toBeOK();

assertThat(response).isOK();

from playwright.async_api import expect

# ...
await expect(response).to_be_ok()

import re
from playwright.sync_api import expect

# ...
expect(response).to_be_ok()

await Expect(response).ToBeOKAsync();

Source: docs/src/api/class-apiresponseassertions.md