主要コンテンツへスキップ

Playwrightライブラリ

Playwrightモジュールは、ブラウザインスタンスを起動するメソッドを提供します。Playwrightを使用して自動化を駆動する典型的な例は次のとおりです。

const { chromium, firefox, webkit } = require('playwright');

(async () => {
  const browser = await chromium.launch();  // Or 'firefox' or 'webkit'.
  const page = await browser.newPage();
  await page.goto('http://example.com');
  // other actions...
  await browser.close();
})();

プロパティ​

chromium​

v1.9より前に追加 playwright.chromium

このオブジェクトは、Chromiumを起動または接続するために使用でき、Browserのインスタンスを返します。

使用方法

playwright.chromium

型

devices​

v1.9より前に追加 playwright.devices

browser.newContext()またはbrowser.newPage()で使用するデバイスの辞書を返します。

const { webkit, devices } = require('playwright');
const iPhone = devices['iPhone 6'];

(async () => {
  const browser = await webkit.launch();
  const context = await browser.newContext({
    ...iPhone
  });
  const page = await context.newPage();
  await page.goto('http://example.com');
  // other actions...
  await browser.close();
})();

使用方法

playwright.devices

型

errors​

v1.9より前に追加 playwright.errors

Playwrightのメソッドは、リクエストを処理できない場合にエラーをスローする可能性があります。たとえば、locator.waitFor()は、指定された時間内にセレクターがノードに一致しない場合に失敗する可能性があります。

特定のエラータイプに対して、Playwrightは特定のエラークラスを使用します。これらのクラスはplaywright.errorsを介して利用できます。

タイムアウトエラーの処理例

try {
  await page.locator('.foo').waitFor();
} catch (e) {
  if (e instanceof playwright.errors.TimeoutError) {
    // Do something if this is a timeout.
  }
}

使用方法

playwright.errors

型

firefox​

v1.9より前に追加 playwright.firefox

このオブジェクトは、Firefoxを起動または接続するために使用でき、Browserのインスタンスを返します。

使用方法

playwright.firefox

型

request​

追加バージョン: v1.16 playwright.request

Web APIテストに使用できるAPIを公開します。

使用方法

playwright.request

型

selectors​

v1.9より前に追加 playwright.selectors

セレクターは、カスタムセレクターエンジンをインストールするために使用できます。拡張性の詳細については、を参照してください。

使用方法

playwright.selectors

型

webkit​

v1.9より前に追加 playwright.webkit

このオブジェクトは、WebKitを起動または接続するために使用でき、Browserのインスタンスを返します。

使用方法

playwright.webkit

型