Playwright ライブラリは、1 つの API を介してブラウザー間の自動化を提供します。
Playwright は、Chromium 、Firefox、WebKit を 1 つの API で自動化するためのNode.jsライブラリです。 Playwright は、常緑、対応、信頼性、高速のクロスブラウザー Web オートメーションを可能にするために構築されています。 Microsoft Edge はオープンソースのChromium Web プラットフォーム上に構築されているため、Playwright は Microsoft Edge を自動化することもできます。
Playwright は既定で ヘッドレス ブラウザー を起動します。 ヘッドレス ブラウザーでは UI が表示されないため、代わりにコマンド ラインを使用する必要があります。 また、完全 (ヘッドレスではない) Microsoft Edge を実行するように Playwright を構成することもできます。
Playwright とブラウザーをインストールする
注
プレイライトには バージョン 12 以上 Node.js 必要です。 コマンド ラインから node -v を実行して、互換性のあるバージョンの Node.js があることを確認します。 Chromium、Firefox、WebKit 用のブラウザー バイナリは、Windows、macOS、Linux で動作します。 詳細については、「 Playwright システム要件」を参照してください。
まず、 Playwright Test をインストールして、Web サイトまたはアプリをテストします。
npm i -D @playwright/test
ブラウザーをインストールするには、Chromium、Firefox、および WebKitをダウンロードする次のコマンドを実行します。
npx playwright install
基本的なテストを実行する
Playwright によって使用されるアプローチは、 WebDriver や Puppeteer などの他のブラウザー テスト フレームワークのユーザーにはなじみがあります。 ブラウザーのインスタンスを作成し、ブラウザーでページを開き、 Playwright API を使用してページを操作できます。
Playwright のテスト ランナーである Playwright テストは、ブラウザーとコンテキストを起動します。 分離されたページは、次の基本的なテストに示すように、すべてのテストに渡されます。
// tests/foo.spec.ts
import { test, expect } from '@playwright/test';
test('basic test', async ({ page }) => {
await page.goto('https://playwright.dev/');
const title = page.locator('.navbar__inner .navbar__title');
await expect(title).toHaveText('Playwright');
});
次に、次のようにテストを実行します。
npx playwright test
テストの実行の詳細については、「 Playwright > の概要」を参照してください。
Microsoft Edge でテストを実行する
Microsoft Edge でテストを実行するには、playwright Test 用の構成ファイル ( playwright.config.tsなど) を作成する必要があります。 構成ファイル内で、Microsoft Edge を使用して 1 つのプロジェクトを作成します。
// playwright.config.ts
import { PlaywrightTestConfig } from '@playwright/test';
const config: PlaywrightTestConfig = {
projects: [
{
name: 'Microsoft Edge',
use: {
// Supported Microsoft Edge channels are: msedge, msedge-beta, msedge-dev, msedge-canary
channel: 'msedge',
},
},
],
};
export default config
Microsoft Edge がまだシステムにインストールされていない場合は、次のように Playwright を使用してインストールします。
npx playwright install msedge
上記の playwright.config.ts ファイルを使用する場合、Playwright Test では、次のように Microsoft Edge を使用してテストを実行します。
npx playwright test --headed
Playwright をライブラリとして使用する
次のコードに示すように、Playwright をライブラリとして使用することもできます。 この方法では、別のテスト ランナーを使用できます。
// example.js
const playwright = require('playwright');
(async () => {
const browser = await playwright.chromium.launch({
channel: 'msedge',
});
const context = await browser.newContext();
const page = await context.newPage();
await page.goto('https://www.microsoft.com/edge');
await page.screenshot({ path: 'example.png' });
await browser.close();
})();
example.js は、Playwright によって有効になっている自動化とテストのシナリオの簡単なデモです。 他の Web ブラウザーでスクリーンショットを取得するには、上記のコードを await playwright.chromium.launch から次のコードに変更します。
Firefox:
const browser = await playwright.firefox.launch({
WebKit:
const browser = await playwright.webkit.launch({
プレイライトとプレイライトのテストの詳細については、 プレイライトの Web サイトを参照してください。 GitHub の Playwright リポジトリ を確認してください。 Playwright で Web サイトまたはアプリの自動化とテストに関するフィードバックを共有するには、 問題を報告します。