BrowserType

BrowserType 提供啟動特定瀏覽器實例或連接到現有實例的方法。以下是使用 Playwright 驅動自動化的典型範例

const { chromium } = require('playwright');  // Or 'firefox' or 'webkit'.

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

方法

connect

新增於 v1.9 之前

browserType.connect

此方法將 Playwright 連接到現有的瀏覽器實例。當連接到另一個透過 Node.js 中的 BrowserType.launchServer 啟動的瀏覽器時，主要版本和次要版本需要與客戶端版本（1.2.3 → 與 1.2.x 相容）匹配。

用法

await browserType.connect(wsEndpoint);
await browserType.connect(wsEndpoint, options);

參數

wsEndpoint string新增於：v1.10#

要連接的瀏覽器 WebSocket 端點。
options Object (可選)
- exposeNetwork string (可選)新增於：v1.37#
  
  此選項將連接用戶端上可用的網路暴露給正在連接的瀏覽器。包含以逗號分隔的規則列表。
  
  可用規則
  1. 主機名稱模式，例如：example.com、*.org:99、x.*.y.com、*foo.org。
  2. IP 字面值，例如：127.0.0.1、0.0.0.0:99、[::1]、[0:0::1]:99。
  3. <loopback>，它匹配本機迴路介面：localhost、*.localhost、127.0.0.1、[::1]。
  一些常見範例
  1. "*" 以暴露所有網路。
  2. "<loopback>" 以暴露 localhost 網路。
  3. "*.test.internal-domain,*.staging.internal-domain,<loopback>" 以暴露測試/預備部署和 localhost。
- headers Object<string, string> (可選)新增於：v1.11#
  
  要與 WebSocket 連接請求一起發送的額外 HTTP 標頭。可選。
- logger Logger (可選)新增於：v1.14#
  
  Playwright 日誌記錄的 Logger sink。可選。
- slowMo number (可選)新增於：v1.10#
  
  以指定的毫秒數減慢 Playwright 操作。方便您查看正在發生的事情。預設為 0。
- timeout number (可選)新增於：v1.10#
  
  等待建立連線的最長時間，以毫秒為單位。預設為 0（無超時）。

Promise<Browser>#

connectOverCDP

新增於：v1.9

browserType.connectOverCDP

此方法使用 Chrome DevTools Protocol 將 Playwright 連接到現有的瀏覽器實例。

預設瀏覽器上下文可透過 browser.contexts() 存取。

注意

僅 Chromium 瀏覽器支援透過 Chrome DevTools Protocol 連接。

用法

const browser = await playwright.chromium.connectOverCDP('https://127.0.0.1:9222');
const defaultContext = browser.contexts()[0];
const page = defaultContext.pages()[0];

參數

endpointURL string新增於：v1.11#

要連接的 CDP WebSocket 端點或 HTTP URL。例如 https://127.0.0.1:9222/ 或 ws://127.0.0.1:9222/devtools/browser/387adf4c-243f-4051-a181-46798f4a46f4。
options Object (可選)
- endpointURL string (可選)新增於：v1.14#
  
  已棄用，請改用第一個參數。可選。
- headers Object<string, string> (可選)新增於：v1.11#
  
  要與連線請求一起發送的額外 HTTP 標頭。可選。
- logger Logger (可選)新增於：v1.14#
  
  Playwright 日誌記錄的 Logger sink。可選。
- slowMo number (可選)新增於：v1.11#
  
  以指定的毫秒數減慢 Playwright 操作。方便您查看正在發生的事情。預設為 0。
- timeout number (可選)新增於：v1.11#
  
  等待建立連線的最長時間，以毫秒為單位。預設為 30000（30 秒）。傳遞 0 以停用超時。

Promise<Browser>#

executablePath

新增於 v1.9 之前

browserType.executablePath

Playwright 預期找到捆綁瀏覽器可執行檔的路徑。

用法

browserType.executablePath();

string #

launch

新增於 v1.9 之前

browserType.launch

返回瀏覽器實例。

用法

您可以使用 ignoreDefaultArgs 從預設參數中篩選出 --mute-audio

const browser = await chromium.launch({  // Or 'firefox' or 'webkit'.
  ignoreDefaultArgs: ['--mute-audio']
});

僅限 Chromium - Playwright 也可用於控制 Google Chrome 或 Microsoft Edge 瀏覽器，但最好與其捆綁的 Chromium 版本一起使用。不保證它適用於任何其他版本。使用 executablePath 選項時請格外小心。

如果偏好使用 Google Chrome（而不是 Chromium），建議使用 Chrome Canary 或 Dev Channel 版本。

像 Google Chrome 和 Microsoft Edge 這樣的庫存瀏覽器適用於需要專有媒體編解碼器進行視訊播放的測試。請參閱這篇文章，了解 Chromium 和 Chrome 之間的其他差異。這篇文章描述了 Linux 使用者的一些差異。

參數

options Object (可選)
- args Array<string> (可選)#
  
  警告
  使用自訂瀏覽器參數的風險由您自行承擔，因為其中一些參數可能會破壞 Playwright 的功能。
  
  要傳遞給瀏覽器實例的其他參數。Chromium 標誌列表可以在這裡找到。
- channel string (可選)#
  
  瀏覽器發行管道。
  
  使用 "chromium" 以選擇加入新的無頭模式。
  
  使用 "chrome"、"chrome-beta"、"chrome-dev"、"chrome-canary"、"msedge"、"msedge-beta"、"msedge-dev" 或 "msedge-canary" 以使用品牌 Google Chrome 和 Microsoft Edge。
- chromiumSandbox boolean (可選)#
  
  啟用 Chromium 沙箱。預設為 false。
- devtools boolean (可選)#
  
  已棄用
  請改用偵錯工具。
  
  僅限 Chromium - 是否為每個標籤頁自動開啟開發人員工具面板。如果此選項為 true，則 headless 選項將設定為 false。
- downloadsPath string (可選)#
  
  如果指定，接受的下載將下載到此目錄中。否則，將建立臨時目錄，並在瀏覽器關閉時刪除。在任何情況下，下載都會在建立它們的瀏覽器上下文關閉時刪除。
- env Object<string, string | number | boolean> (可選)#
  
  指定瀏覽器可見的環境變數。預設為 process.env。
- executablePath string (可選)#
  
  要運行的瀏覽器可執行檔的路徑，而不是捆綁的可執行檔。如果 executablePath 是相對路徑，則它相對於當前工作目錄解析。請注意，Playwright 僅適用於捆綁的 Chromium、Firefox 或 WebKit，使用風險由您自行承擔。
- firefoxUserPrefs Object<string, string | number | boolean> (可選)#
  
  Firefox 使用者偏好設定。在 about:config 了解更多關於 Firefox 使用者偏好設定的資訊。
- handleSIGHUP boolean (可選)#
  
  在 SIGHUP 上關閉瀏覽器進程。預設為 true。
- handleSIGINT boolean (可選)#
  
  在 Ctrl-C 上關閉瀏覽器進程。預設為 true。
- handleSIGTERM boolean (可選)#
  
  在 SIGTERM 上關閉瀏覽器進程。預設為 true。
- headless boolean (可選)#
  
  是否在無頭模式下運行瀏覽器。有關 Chromium 和 Firefox 的更多詳細資訊。預設為 true，除非 devtools 選項為 true。
- ignoreDefaultArgs boolean | Array<string> (可選)#
  
  如果 true，Playwright 不會傳遞自己的配置參數，而僅使用來自 args 的參數。如果給定一個陣列，則過濾掉給定的預設參數。危險選項；謹慎使用。預設為 false。
- logger Logger (可選)#
  
  Playwright 日誌記錄的 Logger sink。
- proxy Object (可選)#
  - server string
    
    用於所有請求的代理。支援 HTTP 和 SOCKS 代理，例如 http://myproxy.com:3128 或 socks5://myproxy.com:3128。簡寫形式 myproxy.com:3128 被視為 HTTP 代理。
  - bypass string (可選)
    
    可選的逗號分隔網域以繞過代理，例如 ".com, chromium.org, .domain.com"。
  - username string (可選)
    
    如果 HTTP 代理需要身份驗證，則使用的可選使用者名稱。
  - password string (可選)
    
    如果 HTTP 代理需要身份驗證，則使用的可選密碼。
  網路代理設定。
- slowMo number (可選)#
  
  以指定的毫秒數減慢 Playwright 操作。方便您查看正在發生的事情。
- timeout number (可選)#
  
  等待瀏覽器實例啟動的最長時間，以毫秒為單位。預設為 30000（30 秒）。傳遞 0 以停用超時。
- tracesDir string (可選)#
  
  如果指定，追蹤將儲存到此目錄中。

Promise<Browser>#

launchPersistentContext

新增於 v1.9 之前

browserType.launchPersistentContext

返回持久瀏覽器上下文實例。

啟動使用位於 userDataDir 的持久儲存的瀏覽器，並返回唯一的上下文。關閉此上下文將自動關閉瀏覽器。

用法

await browserType.launchPersistentContext(userDataDir);
await browserType.launchPersistentContext(userDataDir, options);

參數

userDataDir string #

使用者資料目錄的路徑，用於儲存瀏覽器會話資料，例如 Cookie 和本機儲存。有關 Chromium 和 Firefox 的更多詳細資訊。請注意，Chromium 的使用者資料目錄是在 chrome://version 中看到的「設定檔路徑」的父目錄。傳遞空字串以改用臨時目錄。
options Object (可選)
- acceptDownloads boolean (可選)#
  
  是否自動下載所有附件。預設為 true，表示接受所有下載。
- args Array<string> (可選)#
  
  警告
  使用自訂瀏覽器參數的風險由您自行承擔，因為其中一些參數可能會破壞 Playwright 的功能。
  
  要傳遞給瀏覽器實例的其他參數。Chromium 標誌列表可以在這裡找到。
- baseURL string (可選)#
  
  當使用 page.goto()、page.route()、page.waitForURL()、page.waitForRequest() 或 page.waitForResponse() 時，它會透過使用 URL() 建構函式來建構對應的 URL，從而將 base URL 納入考量。預設為未設定。範例
  - baseURL：https://127.0.0.1:3000，導航到 /bar.html 會產生 https://127.0.0.1:3000/bar.html
  - baseURL：https://127.0.0.1:3000/foo/，導航到 ./bar.html 會產生 https://127.0.0.1:3000/foo/bar.html
  - baseURL：https://127.0.0.1:3000/foo（不帶尾部斜線），導航到 ./bar.html 會產生 https://127.0.0.1:3000/bar.html
- bypassCSP boolean (可選)#
  
  切換繞過頁面的 Content-Security-Policy。預設為 false。
- channel string (可選)#
  
  瀏覽器發行管道。
  
  使用 "chromium" 以選擇加入新的無頭模式。
  
  使用 "chrome"、"chrome-beta"、"chrome-dev"、"chrome-canary"、"msedge"、"msedge-beta"、"msedge-dev" 或 "msedge-canary" 以使用品牌 Google Chrome 和 Microsoft Edge。
- chromiumSandbox boolean (可選)#
  
  啟用 Chromium 沙箱。預設為 false。
- clientCertificates Array<Object> (可選)新增於：1.46#
  - origin string
    
    憑證有效的精確來源。來源包括 https 協定、主機名稱和可選的埠。
  - certPath string (可選)
    
    PEM 格式憑證檔案的路徑。
  - cert Buffer (可選)
    
    PEM 格式憑證的直接值。
  - keyPath string (可選)
    
    PEM 格式私密金鑰檔案的路徑。
  - key Buffer (可選)
    
    PEM 格式私密金鑰的直接值。
  - pfxPath string (可選)
    
    PFX 或 PKCS12 編碼的私密金鑰和憑證鏈檔案的路徑。
  - pfx Buffer (可選)
    
    PFX 或 PKCS12 編碼的私密金鑰和憑證鏈的直接值。
  - passphrase string (可選)
    
    私密金鑰（PEM 或 PFX）的密碼。
  TLS 用戶端身份驗證允許伺服器請求用戶端憑證並驗證它。
  
  詳細資訊
  
  要使用的用戶端憑證陣列。每個憑證物件都必須同時具有 certPath 和 keyPath、單個 pfxPath 或其對應的直接值等效項（cert 和 key，或 pfx）。可選地，如果憑證已加密，則應提供 passphrase 屬性。應提供 origin 屬性，以精確匹配憑證有效的請求來源。
  
  注意
  在 macOS 上使用 WebKit 時，存取 localhost 不會選取用戶端憑證。您可以透過將 localhost 替換為 local.playwright 來使其運作。
- colorScheme null | "light" | "dark" | "no-preference" (可選)#
  
  模擬 prefers-colors-scheme 媒體功能，支援的值為 'light' 和 'dark'。請參閱 page.emulateMedia() 以獲取更多詳細資訊。傳遞 null 會將模擬重置為系統預設值。預設為 'light'。
- deviceScaleFactor number (可選)#
  
  指定裝置縮放比例（可以認為是 dpr）。預設為 1。了解更多關於使用裝置縮放比例模擬裝置的資訊。
- devtools boolean (可選)#
  
  已棄用
  請改用偵錯工具。
  
  僅限 Chromium - 是否為每個標籤頁自動開啟開發人員工具面板。如果此選項為 true，則 headless 選項將設定為 false。
- downloadsPath string (可選)#
  
  如果指定，接受的下載將下載到此目錄中。否則，將建立臨時目錄，並在瀏覽器關閉時刪除。在任何情況下，下載都會在建立它們的瀏覽器上下文關閉時刪除。
- env Object<string, string | number | boolean> (可選)#
  
  指定瀏覽器可見的環境變數。預設為 process.env。
- executablePath string (可選)#
  
  要運行的瀏覽器可執行檔的路徑，而不是捆綁的可執行檔。如果 executablePath 是相對路徑，則它相對於當前工作目錄解析。請注意，Playwright 僅適用於捆綁的 Chromium、Firefox 或 WebKit，使用風險由您自行承擔。
- extraHTTPHeaders Object<string, string> (可選)#
  
  包含要與每個請求一起發送的額外 HTTP 標頭的物件。預設為無。
- firefoxUserPrefs Object<string, string | number | boolean> (可選)新增於：v1.40#
  
  Firefox 使用者偏好設定。在 about:config 了解更多關於 Firefox 使用者偏好設定的資訊。
- forcedColors null | "active" | "none" (可選)#
  
  模擬 'forced-colors' 媒體功能，支援的值為 'active'、'none'。請參閱 page.emulateMedia() 以獲取更多詳細資訊。傳遞 null 會將模擬重置為系統預設值。預設為 'none'。
- geolocation Object (可選)#
  - latitude number
    
    緯度介於 -90 和 90 之間。
  - longitude number
    
    經度介於 -180 和 180 之間。
  - accuracy number (可選)
    
    非負精度值。預設為 0。
- handleSIGHUP boolean (可選)#
  
  在 SIGHUP 上關閉瀏覽器進程。預設為 true。
- handleSIGINT boolean (可選)#
  
  在 Ctrl-C 上關閉瀏覽器進程。預設為 true。
- handleSIGTERM boolean (可選)#
  
  在 SIGTERM 上關閉瀏覽器進程。預設為 true。
- hasTouch boolean (可選)#
  
  指定視窗是否支援觸控事件。預設為 false。了解更多關於行動裝置模擬的資訊。
- headless boolean (可選)#
  
  是否在無頭模式下運行瀏覽器。有關 Chromium 和 Firefox 的更多詳細資訊。預設為 true，除非 devtools 選項為 true。
- httpCredentials Object (可選)#
  - username string
  - password string
  - origin 字串 (string) (選填)
    
    限制在特定來源 (scheme://host:port).
  - send "unauthorized" | "always" (選填)
    
    此選項僅適用於從對應的 APIRequestContext 發送的請求，且不影響從瀏覽器發送的請求。'always' - 每次 API 請求都會發送帶有基本身份驗證憑證的 Authorization 標頭。'unauthorized' - 僅在收到帶有 WWW-Authenticate 標頭的 401 (Unauthorized) 回應時才發送憑證。預設值為 'unauthorized'。
  HTTP 驗證的憑證。如果未指定來源，則在收到未經授權的回應時，使用者名稱和密碼將發送到任何伺服器。
- ignoreDefaultArgs 布林值 (boolean) | 陣列 (Array)<字串 (string)> (選填)#
  
  如果為 true，Playwright 將不會傳遞其自身的配置參數，而僅使用來自 args 的參數。如果給定一個陣列，則會過濾掉給定的預設參數。此選項有風險；請謹慎使用。預設值為 false。
- ignoreHTTPSErrors 布林值 (boolean) (選填)#
  
  在發送網路請求時是否忽略 HTTPS 錯誤。預設值為 false。
- isMobile 布林值 (boolean) (選填)#
  
  是否考慮 meta viewport 標籤並啟用觸控事件。isMobile 是裝置設定的一部分，因此實際上不需要手動設定。預設值為 false，且 Firefox 不支援。深入瞭解行動裝置模擬。
- javaScriptEnabled 布林值 (boolean) (選填)#
  
  是否在此環境中啟用 JavaScript。預設值為 true。深入瞭解停用 JavaScript。
- locale 字串 (string) (選填)#
  
  指定使用者地區設定，例如 en-GB、de-DE 等。地區設定將影響 navigator.language 值、Accept-Language 請求標頭值以及數字和日期格式規則。預設為系統預設地區設定。深入瞭解我們的模擬指南中的模擬。
- logger Logger (選填)#
  
  Playwright 日誌記錄的 Logger sink。
- offline 布林值 (boolean) (選填)#
  
  是否模擬網路離線狀態。預設值為 false。深入瞭解網路模擬。
- permissions 陣列 (Array)<字串 (string)> (選填)#
  
  要授予此環境中所有頁面的權限列表。有關更多詳細資訊，請參閱 browserContext.grantPermissions()。預設為無。
- proxy 物件 (Object) (選填)#
  - server string
    
    用於所有請求的代理。支援 HTTP 和 SOCKS 代理，例如 http://myproxy.com:3128 或 socks5://myproxy.com:3128。簡寫形式 myproxy.com:3128 被視為 HTTP 代理。
  - bypass string (可選)
    
    可選的逗號分隔網域以繞過代理，例如 ".com, chromium.org, .domain.com"。
  - username string (可選)
    
    如果 HTTP 代理需要身份驗證，則使用的可選使用者名稱。
  - password string (可選)
    
    如果 HTTP 代理需要身份驗證，則使用的可選密碼。
  網路代理設定。
- recordHar 物件 (Object) (選填)#
  - omitContent 布林值 (boolean) (選填)
    
    可選設定，用於控制是否從 HAR 中省略請求內容。預設值為 false。已棄用，請改用 content 策略。
  - content "omit" | "embed" | "attach" (選填)
    
    可選設定，用於控制資源內容管理。如果指定 omit，則不會持久儲存內容。如果指定 attach，則資源將以單獨檔案或 ZIP 封存中的條目形式持久儲存。如果指定 embed，則內容將依照 HAR 規範內嵌儲存在 HAR 檔案中。對於 .zip 輸出檔案，預設值為 attach，對於所有其他檔案副檔名，預設值為 embed。
  - path 字串 (string)
    
    檔案系統上用於寫入 HAR 檔案的路徑。如果檔案名稱以 .zip 結尾，則預設使用 content: 'attach'。
  - mode "full" | "minimal" (選填)
    
    當設定為 minimal 時，僅記錄從 HAR 路由所需的資訊。這會省略大小、時間、頁面、Cookie、安全性和其他類型的 HAR 資訊，這些資訊在從 HAR 重新播放時不會使用。預設值為 full。
  - urlFilter 字串 (string) | RegExp (選填)
    
    用於篩選儲存在 HAR 中的請求的 glob 或正則表達式模式。當透過環境選項提供 baseURL 且傳遞的 URL 是路徑時，它會透過 new URL() 建構函式合併。預設為無。
  啟用將所有頁面的 HAR 記錄到 recordHar.path 檔案中。如果未指定，則不會記錄 HAR。請務必等待 browserContext.close() 以儲存 HAR。
- recordVideo 物件 (Object) (選填)#
  - dir 字串 (string)
    
    用於存放影片的目錄路徑。
  - size 物件 (Object) (選填)
    - width 數字 (number)
      
      影片幀寬度。
    - height 數字 (number)
      
      影片幀高度。
    錄製影片的可選尺寸。如果未指定，則尺寸將等於縮小以適合 800x800 的 viewport。如果未明確配置 viewport，則影片尺寸預設為 800x450。如有必要，每個頁面的實際圖片將縮小以符合指定的尺寸。
  啟用將所有頁面的影片錄製到 recordVideo.dir 目錄中。如果未指定，則不會錄製影片。請務必等待 browserContext.close() 以儲存影片。
- reducedMotion null | "reduce" | "no-preference" (選填)#
  
  模擬 'prefers-reduced-motion' 媒體功能，支援的值為 'reduce'、'no-preference'。有關更多詳細資訊，請參閱 page.emulateMedia()。傳遞 null 會將模擬重設為系統預設值。預設值為 'no-preference'。
- screen 物件 (Object) (選填)#
  - width 數字 (number)
    
    頁面寬度，以像素為單位。
  - height 數字 (number)
    
    頁面高度，以像素為單位。
  模擬透過 window.screen 在網頁內可用的螢幕尺寸一致性。僅在設定 viewport 時使用。
- serviceWorkers "allow" | "block" (選填)#
  
  是否允許網站註冊 Service Worker。預設值為 'allow'。
  - 'allow': 可以註冊 Service Worker。
  - 'block': Playwright 將阻止所有 Service Worker 的註冊。
- slowMo 數字 (number) (選填)#
  
  以指定的毫秒數減慢 Playwright 操作。方便您查看正在發生的事情。
- strictSelectors 布林值 (boolean) (選填)#
  
  如果設定為 true，則為此環境啟用嚴格選取器模式。在嚴格選取器模式下，對選取器的所有操作（暗示單一目標 DOM 元素）在多個元素符合選取器時都會拋出錯誤。此選項不影響任何 Locator API（Locator 始終是嚴格的）。預設值為 false。請參閱 Locator 以深入瞭解嚴格模式。
- timeout 數字 (number) (選填)#
  
  等待瀏覽器實例啟動的最長時間，以毫秒為單位。預設為 30000（30 秒）。傳遞 0 以停用超時。
- timezoneId 字串 (string) (選填)#
  
  變更環境的時區。請參閱 ICU 的 metaZones.txt 以取得支援的時區 ID 列表。預設為系統時區。
- tracesDir 字串 (string) (選填)#
  
  如果指定，追蹤將儲存到此目錄中。
- userAgent 字串 (string) (選填)#
  
  在此環境中使用的特定使用者代理程式。
- videoSize 物件 (Object) (選填)#
  
  已棄用
  請改用 recordVideo。
  - width 數字 (number)
    
    影片幀寬度。
  - height 數字 (number)
    
    影片幀高度。
- videosPath 字串 (string) (選填)#
  
  已棄用
  請改用 recordVideo。
- viewport null | 物件 (Object) (選填)#
  - width 數字 (number)
    
    頁面寬度，以像素為單位。
  - height 數字 (number)
    
    頁面高度，以像素為單位。
  為每個頁面模擬一致的 viewport。預設為 1280x720 viewport。使用 null 停用一致的 viewport 模擬。深入瞭解 viewport 模擬。
  
  注意
  null 值會退出預設預設值，使 viewport 取決於作業系統定義的主機視窗大小。這會使測試的執行變得不確定。

Promise<BrowserContext>#

launchServer

新增於 v1.9 之前

browserType.launchServer

傳回瀏覽器應用程式實例。您可以透過 browserType.connect() 連線到它，這需要主要/次要客戶端/伺服器版本匹配 (1.2.3 → 與 1.2.x 相容)。

用法

啟動瀏覽器伺服器，客戶端可以連線到該伺服器。以下是啟動瀏覽器可執行檔並稍後連線到它的範例

const { chromium } = require('playwright');  // Or 'webkit' or 'firefox'.

(async () => {
  const browserServer = await chromium.launchServer();
  const wsEndpoint = browserServer.wsEndpoint();
  // Use web socket endpoint later to establish a connection.
  const browser = await chromium.connect(wsEndpoint);
  // Close browser instance.
  await browserServer.close();
})();

參數

options Object (可選)
- args 陣列 (Array)<字串 (string)> (選填)#
  
  警告
  使用自訂瀏覽器參數的風險由您自行承擔，因為其中一些參數可能會破壞 Playwright 的功能。
  
  要傳遞給瀏覽器實例的其他參數。Chromium 標誌列表可以在這裡找到。
- channel 字串 (string) (選填)#
  
  瀏覽器發行管道。
  
  使用 "chromium" 以選擇加入新的無頭模式。
  
  使用 "chrome"、"chrome-beta"、"chrome-dev"、"chrome-canary"、"msedge"、"msedge-beta"、"msedge-dev" 或 "msedge-canary" 以使用品牌 Google Chrome 和 Microsoft Edge。
- chromiumSandbox 布林值 (boolean) (選填)#
  
  啟用 Chromium 沙箱。預設為 false。
- devtools 布林值 (boolean) (選填)#
  
  已棄用
  請改用偵錯工具。
  
  僅限 Chromium 是否為每個分頁自動開啟開發人員工具面板。如果此選項為 true，則 headless 選項將設定為 false。
- downloadsPath 字串 (string) (選填)#
  
  如果指定，接受的下載將下載到此目錄中。否則，將建立臨時目錄，並在瀏覽器關閉時刪除。在任何情況下，下載都會在建立它們的瀏覽器上下文關閉時刪除。
- env 物件 (Object)<字串 (string), 字串 (string) | 數字 (number) | 布林值 (boolean)> (選填)#
  
  指定瀏覽器可見的環境變數。預設為 process.env。
- executablePath 字串 (string) (選填)#
  
  要執行的瀏覽器可執行檔路徑，而不是捆綁的版本。如果 executablePath 是相對路徑，則相對於當前工作目錄解析。請注意，Playwright 僅適用於捆綁的 Chromium、Firefox 或 WebKit，風險自負。
- firefoxUserPrefs 物件 (Object)<字串 (string), 字串 (string) | 數字 (number) | 布林值 (boolean)> (選填)#
  
  Firefox 使用者偏好設定。在 about:config 了解更多關於 Firefox 使用者偏好設定的資訊。
- handleSIGHUP 布林值 (boolean) (選填)#
  
  在 SIGHUP 上關閉瀏覽器進程。預設為 true。
- handleSIGINT 布林值 (boolean) (選填)#
  
  在 Ctrl-C 上關閉瀏覽器進程。預設為 true。
- handleSIGTERM 布林值 (boolean) (選填)#
  
  在 SIGTERM 上關閉瀏覽器進程。預設為 true。
- headless 布林值 (boolean) (選填)#
  
  是否在無頭模式下運行瀏覽器。有關 Chromium 和 Firefox 的更多詳細資訊。預設為 true，除非 devtools 選項為 true。
- host 字串 (string) (選填)新增於：v1.45#
  
  用於 WebSocket 的主機。它是可選的，如果省略，則伺服器將接受未指定的 IPv6 位址 (::)（如果 IPv6 可用）或未指定的 IPv4 位址 (0.0.0.0)（否則）。考慮使用選擇特定介面來加強安全性。
- ignoreDefaultArgs 布林值 (boolean) | 陣列 (Array)<字串 (string)> (選填)#
  
  如果為 true，Playwright 將不會傳遞其自身的配置參數，而僅使用來自 args 的參數。如果給定一個陣列，則會過濾掉給定的預設參數。此選項有風險；請謹慎使用。預設值為 false。
- logger Logger (選填)#
  
  Playwright 日誌記錄的 Logger sink。
- port 數字 (number) (選填)#
  
  用於 WebSocket 的端口。預設值為 0，表示選擇任何可用的端口。
- proxy 物件 (Object) (選填)#
  - server string
    
    用於所有請求的代理。支援 HTTP 和 SOCKS 代理，例如 http://myproxy.com:3128 或 socks5://myproxy.com:3128。簡寫形式 myproxy.com:3128 被視為 HTTP 代理。
  - bypass string (可選)
    
    可選的逗號分隔網域以繞過代理，例如 ".com, chromium.org, .domain.com"。
  - username string (可選)
    
    如果 HTTP 代理需要身份驗證，則使用的可選使用者名稱。
  - password string (可選)
    
    如果 HTTP 代理需要身份驗證，則使用的可選密碼。
  網路代理設定。
- timeout 數字 (number) (選填)#
  
  等待瀏覽器實例啟動的最長時間，以毫秒為單位。預設為 30000（30 秒）。傳遞 0 以停用超時。
- tracesDir 字串 (string) (選填)#
  
  如果指定，追蹤將儲存到此目錄中。
- wsPath 字串 (string) (選填)新增於：v1.15#
  
  用於提供瀏覽器伺服器的路徑。為了安全起見，預設為無法猜測的字串。
  
  警告
  任何知道 wsPath 的進程或網頁（包括在 Playwright 中運行的那些）都可以控制 OS 使用者。因此，在使用此選項時，應使用無法猜測的令牌。

Promise<BrowserServer>#

name

新增於 v1.9 之前

browserType.name

傳回瀏覽器名稱。例如：'chromium'、'webkit' 或 'firefox'。

用法

browserType.name();

字串 (string)#

方法​

connect​

connectOverCDP​

executablePath​

launch​

launchPersistentContext​

launchServer​

name​

方法

connect

connectOverCDP

executablePath

launch

launchPersistentContext

launchServer

name