class: BrowserFetcher v0.9.0

BrowserFetcher 可以用來下載和管理不同版本的 Chromium。 BrowserFetcher 操作一個修訂版本字符串，修訂版本字符串指定了一個 Chromium 的確定版本，例如 "533271"。修訂版本字符串可以從 omahaproxy.appspot.com 獲取。 看下面這個例子，他將告訴你如何使用 BrowserFetcher 下載一個指定版本的 Chromium：

const browserFetcher = puppeteer.createBrowserFetcher();
const revisionInfo = await browserFetcher.download('533271');
const browser = await puppeteer.launch({
    executablePath: revisionInfo.executablePath
})

注意 BrowserFetcher 不適用于與共享下載目錄的其他實例同時運行。

Methods

• browserFetcher.canDownload(revision)v0.9.0
• browserFetcher.download(revision[, progressCallback])v0.9.0
• browserFetcher.localRevisions()v0.9.0
• browserFetcher.platform()v0.9.0
• browserFetcher.remove(revision)v0.9.0
• browserFetcher.revisionInfo(revision)v0.9.0

Methods

browserFetcher.canDownload- (revision)v0.9.0

• revision <string> 修訂版本號, 檢查其可用性
• returns: <Promise<boolean>> 返回 true 如果該修訂版本可以從主機下載

該方法將會發(fā)起一個 HEAD 請求來檢查該修訂版本是否有效。

browserFetcher.download(revision[, progressCallback])v0.9.0

• revision <string> 下載的修訂版本。
• progressCallback <function(number, number)> 一個函數(shù), 調(diào)用時將會傳入兩個參數(shù)：
  • downloadedBytes <number> 多少字節(jié)已經(jīng)被下載
  • totalBytes <number> 下載全部的字節(jié)數(shù)(譯者注: 也就是需要下載的文件大小)
• returns: <Promise<Object>> Resolves with revision information when the revision is downloaded and extracted

• revision <string> 該修訂版本被創(chuàng)建時的信息
• folderPath <string> 解壓該修訂版本的路徑
• executablePath <string> 該修訂版本的可執(zhí)行文件的路徑 url <string> URL 該修訂版本的下載路徑

• local <boolean> 該修訂版本是否是在本地的磁盤上是可用的

  該方法將會發(fā)起一個 GET 請求來從主機下載該修訂版本。

browserFetcher.localRevisions()v0.9.0 returns: <Promise<Array<string>>> 一個列表, 包含所有的在本地磁盤可用的修訂版本

browserFetcher.platform()v0.9.0

returns: <string> 返回 mac， linux， win32 或 win64 之一。

browserFetcher.remove(revision)v0.9.0

• revision <string> 想要移除的修訂版本，如果指定的修訂版本還沒有被下載，該方法將拋出一個錯誤
• returns: <Promise> Resolves when the revision has been removed.

browserFetcher.revisionInfo(revision)v0.9.0

revision <string> 想要獲取信息的修訂版本

• returns: <Object>
  • revision <string> 該修訂版本被創(chuàng)建時的信息 folderPath <string> 解壓該修訂版本的路徑
  • executablePath <string> 該修訂版本的可執(zhí)行文件的路徑
  • url <string> URL 該修訂版本的下載路徑
  • local <boolean> 該修訂版本是否是在本地的磁盤上是可用的