Playwright v1.64.0 — WebMCP, нові можливості Test Runner та Locators

💡 Усі статті, обговорення, новини про тестування — в одному місці. Приєднуйтесь до QA спільноти!

Вітаю! Playwright релізнув версію 1.64.0.

Цього разу маємо інтеграцію з WebMCP, палучше відео, нові можливості для запуска тестів, чуть фічей по роботі з локаторами та декілька breaking changes.

Пагналі по основним змінам.

WebMCP — інтеграція з AI-агентами

Одна з найцікавіших новинок — підтримка експериментального WebMCP.

WebMCP дозволяє апці реєструвати інструменти(tools) через які AI-агенти можуть взаємодіяти з браузером.

Playwright отримав два нові API: page.webmcp та frame.webmcp.

Тепер можна отримувати список зареєстрованих інструментів і безпосередньо викликати їх у тестах.

const browser = await chromium.launch({
  args: ['--enable-features=WebMCP'],
});

const page = await browser.newPage();
await page.goto('https://example.com');
const tools = await page.webmcp.tools();
for (const tool of tools) {
  console.log(tool.name, tool.description);
}
const result = await page.webmcp.callTool('add', {
  a: 2,
  b: 40,
});
console.log(result.content[0].text); // "42"

Такж WebMCP підтримується в Playwright MCP. Інструменти які реєструє сторінка автоматично стають доступними агенту з префіксом webmcp_.

Для playwright-cli додали команди:

playwright-cli webmcp-list playwright-cli webmcp-call search_catalog \   --params '{"query":"cats"}'

застосування: якщо ваш продукт надає AI-агентам доступ до операцій через WebMCP, тепер оці операції можна покривати автотестами.

Покращений відеозапис

Тепер через fps можна задавати частоту кадрів, а за допомогою CSS — стилізувати візуалізацію дій користувача: позицію курсора, підсвічування елементів та назви дій.

// playwright.config.ts
import { defineConfig } from '@playwright/test';

export default defineConfig({
  use: {
    video: {
      mode: 'retain-on-failure',
      size: { width: 1920, height: 1080 },
      fps: 60,
      show: {
        actions: {
          style: {
            point: 'width: 20px; height: 20px; border-radius: 50%; background: red',
            highlight: 'outline: 2px solid #333',
            title: 'font-size: 16px',
          },
        },
      },
    },
  },
});

Що змінилося:

  • Додано fps для testOptions.video, recordVideo та screencast.start(). Firefox і WebKit наразі підтримують запис максимум із 25 FPS.
  • Курсор залишається видимим після останньої дії, не зникає під час навігації та рухається плавнішою траєкторією.
  • Замість VP8 використовується VP9, що дозволяє отримувати менші відеофайли за аналогічної або кращої якості.
  • Нова опція style замінює попередню fontSize, яка тепер deprecated.

Для CI я б залишив retain-on-failure або on-first-retry, а не запис кожного тесту. Особливо якщо у вас тисячі тестів і є обмеження на обсяг artifacts.

Test Runner — контроль запуску тестів

Default Projects

Нова опція testProject.default дозволяє залишити проєкт у конфігурації, але не запускати його за замовчуванням.

export default defineConfig(
{
  projects: [
    {
      name: 'chromium',
      use: devices['Desktop Chrome'],
    },
    {
      name: 'firefox',
      use: devices['Desktop Firefox'],
      default: false,
    },
    {
      name: 'webkit',
      use: devices['Desktop Safari'],
      default: false,
    },
  ],
});

Тепер можна запускати:

# Тільки Chromium
npx playwright test

# Тільки Firefox
npx playwright test --project=firefox

# Усі проєкти
npx playwright test --project="*"

Shuffle — випадковий порядок тестів

Додано CLI-опцію --shuffle, яка запускає тести у випадковому порядку.

npx playwright test --shuffle

Playwright виводить seed, який можна використати для повторного запуску в тому самому порядку:

npx playwright test --shuffle 271828182

Test Locks на рівні describe

У Playwright 1.63 з’явилися Test Locks, про які я писав раніше.

У версії 1.64 їх можна конфігурувати для всієї групи тестів через test.describe.configure().

test.describe('User settings', () => 
{
  test.describe.configure({
    lock: 'user-settings',
  });

  test('update profile', async ({ page }) => {
    // ...
  });

  test('change password', async ({ page }) => {
    // ...
  });
});

Тепер не потрібно дублювати однаковий lock для кожного тесту.

Це зручно, якщо декілька тестів використовують один ресурс: test account, sandbox provider або спільні налаштування застосунку.

Але не використовуйте locks як універсальне рішення проблем із паралельністю — зайва синхронізація знижує ефективність parallel execution.

WebP для Screenshot Assertions

Нова опція type у toHaveScreenshot дозволяє зберігати unnamed screenshots у форматі WebP.

export default defineConfig(
{
  expect: {
    toHaveScreenshot: {
      type: 'webp',
    },
  },
});

Це може бути корисно для visual regression testing, коли велика кількість screenshot baselines збільшує розмір репозиторію та CI artifacts.

Враховуйте, що зміна формату потребуватиме перевірки наявних snapshots та процесу їх оновлення.

Locator.within() - зручніша робота зі складними елементами

Новий метод locator.within() дозволяє обмежити пошук елемента іншим локатором.

const saveButton = page.getByRole('button', {
  name: 'Save',
});

const dialog = page.getByTestId('settings-dialog');

await saveButton.within(dialog).click();

Фактично ми говоримо Playwright: знайди кнопку Save всередині конкретного діалогового вікна.

Особливо цікава поведінка з nth() та first(). Вони можуть застосовуватися окремо в межах кожного батьківського елемента.

Наприклад, потрібно перевірити третю колонку таблиці:

const thirdColumn = page
  .getByRole('cell')
  .nth(2)
  .within(page.getByRole('row'));

await expect(thirdColumn).toHaveText([
  'Apple',
  'Banana',
  'Cherry',
]);

Тут nth(2) означає третю комірку кожного рядка, а не третю комірку всієї таблиці.

Це робить роботу з таблицями, списками та повторюваними UI-компонентами зручнішою.

Інші нові API

page.getByRef()

Новий page.getByRef() дозволяє знаходити елементи за ARIA reference, наприклад e2, отриманим із page.ariaSnapshot() у режимі ai.

Це насамперед цікаво для AI-driven automation, де агент аналізує accessibility snapshot і використовує відповідні references для взаємодії зі сторінкою.

Shadow DOM

Методи page.content() і frame.content() отримали опцію includeShadow, яка дозволяє серіалізувати відкриті Shadow DOM roots у форматі declarative Shadow DOM.

Корисно для діагностики застосунків, які активно використовують Web Components.

APIRequestContext Cookies

Додано методи addCookies(), cookies() та clearCookies() для API request context.

await request.addCookies([
  {
    name: 'session-id',
    value: '42',
    url: 'https://example.com',
  },
]);

const cookies = await request.cookies(
  'https://example.com'
);

await request.clearCookies({
  name: 'session-id',
});

Тепер можна безпосередньо керувати cookies на рівні API-контексту без додаткової роботи з browser context.

Це зручно для API testing, session-based authentication та сценаріїв, у яких потрібно підготувати авторизований стан перед виконанням HTTP-запитів.

Інше

fullConfig.filteredProjects — дозволяє в global setup і reporters отримати список projects, які реально вибрані для запуску після застосування фільтра --project.

credentials.create() — отримав опцію signCount для встановлення початкового лічильника підписів віртуального credential. Його значення також повертається через credentials.create() і credentials.get() та зберігається у storage state. Корисно для тестування WebAuthn.

Breaking Changes — на що звернути увагу

Device emulation та screen

Тепер device descriptors передають значення screen до browser context.

Якщо використовуєте devices['Desktop Chrome'] або інші готові профілі, значення window.screen та результати media queries можуть змінитися.

Для збереження попередньої поведінки можна явно встановити:

use: {   ...devices['Desktop Chrome'],   screen: undefined, }

JSX та TypeScript

Компіляція JSX у тестових файлах тепер враховує параметри jsx, jsxFactory, jsxFragmentFactory та jsxImportSource з tsconfig.json.

За замовчуванням використовується automatic runtime із react/jsx-runtime.

Якщо маєте тести з JSX або власні JSX factories, рекомендую перевірити їх після оновлення.

Snapshot updates

Змінено поведінку --update-snapshots=missing.

Тепер test run може завершитися успішно, якщо відсутні snapshots були створені, а всі наявні успішно пройшли перевірку.

Попередня поведінка за замовчуванням зберігається в режимі default: відсутній snapshot створюється, але тест завершується помилкою.

Враховуйте це, якщо CI pipeline автоматично генерує або перевіряє snapshots.

Hidden iframes

Елементи всередині прихованого iframe тепер також вважаються прихованими.

Це впливає на locator.isVisible(), expect(locator).toBeVisible() та дії, які перевіряють видимість елементів.

Якщо ваші тести взаємодіють із прихованими iframe, наприклад у сторонніх віджетах чи інтеграціях, їхню поведінку варто перевірити після оновлення.

Підсумок

Для мене найкорисніші зміни цього релізу — --shuffle для виявлення залежностей між тестами, testProject.default для оптимізації локального запуску та locator.within() для роботи зі складними UI-компонентами.

Окремо варто відзначити WebMCP. Хоча це все ще експериментальна технологія але її інтеграція з Playwright дає нові можливості для автоматизованого тестування апок, орієнтованих на AI-агентів.

Всім гарного дня, стабільних тестів та буду радий бачити у своїй групі, щоб слідкувати за оновленнями світу розробки та тестування!

👍ПодобаєтьсяСподобалось2
До обраногоВ обраному0
LinkedIn
Дозволені теги: blockquote, a, pre, code, ul, ol, li, b, i, del.
Ctrl + Enter
Дозволені теги: blockquote, a, pre, code, ul, ol, li, b, i, del.
Ctrl + Enter