PuppeteerNode 類別

擴展主要的 Puppeteer 類別，加入 Node 特定行為，以用於獲取和下載瀏覽器。

如果您在 Node 環境中使用 Puppeteer，執行 require('puppeteer') （或對等的 ES import）時，將會取得此類別。

簽章

export declare class PuppeteerNode extends Puppeteer

擴展自： Puppeteer

備註

最常用的方法是 launch，用於啟動並連線至新的瀏覽器實例。

請參閱 主要 Puppeteer 類別，以了解所有環境通用的方法，例如 Puppeteer.connect()。

此類別的建構函式標示為內部使用。第三方程式碼不應直接呼叫建構函式或建立擴展 PuppeteerNode 類別的子類別。

範例

以下是使用 Puppeteer 進行自動化的典型範例

import puppeteer from 'puppeteer';

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

建立 page 後，您可以使用大量的 API 與頁面互動、導覽或在該頁面中尋找特定元素。「`page` 文件」列出了所有可用的方法。

屬性

屬性	修飾詞	類型	描述
defaultBrowser	唯讀	SupportedBrowser	預設啟動的瀏覽器名稱。對於 puppeteer，這會受到您的組態影響。否則，為 chrome。
lastLaunchedBrowser	唯讀	SupportedBrowser	上次啟動的瀏覽器名稱。
product	唯讀，已棄用	string	已棄用 請勿使用此欄位，因為它不會將不同類型的多個瀏覽器納入考量。請使用 defaultBrowser 或 lastLaunchedBrowser。

方法

方法	修飾詞	描述
connect(options)		此方法將 Puppeteer 連接至現有的瀏覽器實例。
defaultArgs(options)
executablePath(channel)		指定 ChromeReleaseChannel 的預設可執行檔路徑。
executablePath(options)		指定 LaunchOptions 的預設可執行檔路徑。
executablePath()		預設可執行檔路徑。
launch(options)		在指定時，使用給定的引數和選項啟動瀏覽器實例。 搭配 puppeteer-core 使用時，必須提供 options.executablePath 或 options.channel。 備註 Puppeteer 也可用於控制 Chrome 瀏覽器，但最好搭配預設下載的 Chrome for Testing 版本使用。無法保證它能與任何其他版本搭配使用。如果偏好使用 Google Chrome (而非 Chrome for Testing)，建議使用 Chrome Canary 或 Dev Channel 版本。請參閱 本文，以了解 Chromium 和 Chrome 之間的差異。本文描述了 Linux 使用者的一些差異。請參閱 這份文件，以了解 Chrome for Testing 的描述。
trimCache()		移除快取目錄中所有非目前的 Firefox 和 Chrome 二進位檔，該快取目錄由提供的 Puppeteer 組態識別。目前的瀏覽器版本由從 Puppeteer 解析 PUPPETEER_REVISIONS 來決定，除非提供 configuration.browserRevision。 備註 請注意，此方法不會檢查主機上安裝的其他 Puppeteer 版本是否需要使用相同快取目錄的非目前二進位檔。