跳到主要內容

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

公開 API，可用於 Web API 測試。

用法

playwright.request

類型

selectors​

在 v1.9 之前新增 playwright.selectors

選取器可用於安裝自訂選取器引擎。請參閱 extensibility 以取得更多資訊。

用法

playwright.selectors

類型

webkit​

在 v1.9 之前新增 playwright.webkit

此物件可用於啟動或連線到 WebKit，並傳回 Browser 的實例。

用法

playwright.webkit

類型