安裝
要在您的專案中使用 Puppeteer,請執行
- npm
- Yarn
- pnpm
npm i puppeteer
yarn add puppeteer
pnpm add 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';