跳至主要內容
版本:23.11.1

安裝

要在您的專案中使用 Puppeteer,請執行

npm i puppeteer

當您安裝 Puppeteer 時,它會自動下載最新版本的 Chrome for Testing(macOS 約 170MB、Linux 約 282MB、Windows 約 280MB)和一個 chrome-headless-shell 二進制檔案(從 Puppeteer v21.6.0 開始),該檔案保證能與 Puppeteer 搭配使用。預設情況下,瀏覽器會下載到 $HOME/.cache/puppeteer 資料夾(從 Puppeteer v19.0.0 開始)。請參閱設定,了解設定選項和環境變數,以控制下載行為。

自 v1.7.0 以來的每個版本,我們都會發佈兩個套件

puppeteer 是一個用於瀏覽器自動化的產品。安裝後,它會下載一個 Chrome 版本,然後使用 puppeteer-core 驅動它。作為一個終端用戶產品,puppeteer 使用合理的預設值自動化幾個工作流程,這些預設值可以自訂

puppeteer-core 是一個函式庫,可協助驅動任何支援 DevTools 協議的項目。作為一個函式庫,puppeteer-core 完全透過其程式化介面驅動,這意味著不假設任何預設值,並且安裝 puppeteer-core 時不會下載 Chrome。

如果您要連線到遠端瀏覽器自行管理瀏覽器,則應使用 puppeteer-core。如果您要自行管理瀏覽器,則需要使用明確的 executablePath(或如果它安裝在標準位置,則使用channel)呼叫 puppeteer.launch

使用 puppeteer-core 時,請記得更改匯入

import puppeteer from 'puppeteer-core';