From 54b0bcbc468ecdd74aaddb898a5d754cd65de976 Mon Sep 17 00:00:00 2001 From: Alex Rudenko Date: Fri, 24 Nov 2023 11:01:53 +0100 Subject: [PATCH] docs: update faq (#11441) --- Herebyfile.mjs | 2 +- README.md | 2 +- docs/api/puppeteer.puppeteernode.launch.md | 2 +- docs/chromium-support.md | 26 +++---- docs/faq.md | 72 +++++++------------ docs/guides/docker.md | 2 +- docs/index.md | 2 +- .../puppeteer-core/src/node/PuppeteerNode.ts | 2 +- .../api/puppeteer.puppeteernode.launch.md | 2 +- .../version-21.5.2/chromium-support.md | 26 +++---- website/versioned_docs/version-21.5.2/faq.md | 2 +- .../version-21.5.2/guides/docker.md | 2 +- .../versioned_docs/version-21.5.2/index.md | 2 +- 13 files changed, 63 insertions(+), 81 deletions(-) diff --git a/Herebyfile.mjs b/Herebyfile.mjs index 486b630d976..a49f7ef88cd 100644 --- a/Herebyfile.mjs +++ b/Herebyfile.mjs @@ -45,7 +45,7 @@ export const docsChromiumSupportTask = task({ } if (semver.gte(puppeteerVersion, '20.0.0')) { buffer.push( - ` * [Chrome for Testing](https://goo.gle/chrome-for-testing) ${chromiumVersion} - [Puppeteer ${puppeteerVersion}](${getApiUrl( + ` * [Chrome for Testing](https://developer.chrome.com/blog/chrome-for-testing/) ${chromiumVersion} - [Puppeteer ${puppeteerVersion}](${getApiUrl( puppeteerVersion )})` ); diff --git a/README.md b/README.md index 3fc9c9df0fb..2f87f664314 100644 --- a/README.md +++ b/README.md @@ -46,7 +46,7 @@ pnpm i puppeteer ``` When you install Puppeteer, it automatically downloads a recent version of -[Chrome for Testing](https://goo.gle/chrome-for-testing) (~170MB macOS, ~282MB Linux, ~280MB Windows) that is [guaranteed to +[Chrome for Testing](https://developer.chrome.com/blog/chrome-for-testing/) (~170MB macOS, ~282MB Linux, ~280MB Windows) that is [guaranteed to work](https://pptr.dev/faq#q-why-doesnt-puppeteer-vxxx-work-with-chromium-vyyy) with Puppeteer. The browser is downloaded to the `$HOME/.cache/puppeteer` folder by default (starting with Puppeteer v19.0.0). diff --git a/docs/api/puppeteer.puppeteernode.launch.md b/docs/api/puppeteer.puppeteernode.launch.md index 4b1db660e55..78cae2896e9 100644 --- a/docs/api/puppeteer.puppeteernode.launch.md +++ b/docs/api/puppeteer.puppeteernode.launch.md @@ -28,7 +28,7 @@ Promise<[Browser](./puppeteer.browser.md)> ## Remarks -Puppeteer can also be used to control the Chrome browser, but it works best with the version of Chrome for Testing downloaded by default. There is no guarantee it will work with any other version. If Google Chrome (rather than Chrome for Testing) is preferred, a [Chrome Canary](https://www.google.com/chrome/browser/canary.html) or [Dev Channel](https://www.chromium.org/getting-involved/dev-channel) build is suggested. See [this article](https://www.howtogeek.com/202825/what%E2%80%99s-the-difference-between-chromium-and-chrome/) for a description of the differences between Chromium and Chrome. [This article](https://chromium.googlesource.com/chromium/src/+/lkgr/docs/chromium_browser_vs_google_chrome.md) describes some differences for Linux users. See [this doc](https://goo.gle/chrome-for-testing) for the description of Chrome for Testing. +Puppeteer can also be used to control the Chrome browser, but it works best with the version of Chrome for Testing downloaded by default. There is no guarantee it will work with any other version. If Google Chrome (rather than Chrome for Testing) is preferred, a [Chrome Canary](https://www.google.com/chrome/browser/canary.html) or [Dev Channel](https://www.chromium.org/getting-involved/dev-channel) build is suggested. See [this article](https://www.howtogeek.com/202825/what%E2%80%99s-the-difference-between-chromium-and-chrome/) for a description of the differences between Chromium and Chrome. [This article](https://chromium.googlesource.com/chromium/src/+/lkgr/docs/chromium_browser_vs_google_chrome.md) describes some differences for Linux users. See [this doc](https://developer.chrome.com/blog/chrome-for-testing/) for the description of Chrome for Testing. ## Example diff --git a/docs/chromium-support.md b/docs/chromium-support.md index baf3a1a96fa..e725ec942d6 100644 --- a/docs/chromium-support.md +++ b/docs/chromium-support.md @@ -4,19 +4,19 @@ The following versions of Chromium are supported, mapped to Puppeteer version: -- [Chrome for Testing](https://goo.gle/chrome-for-testing) 119.0.6045.105 - [Puppeteer v21.5.0](https://github.com/puppeteer/puppeteer/blob/puppeteer-v21.5.0/docs/api/index.md) -- [Chrome for Testing](https://goo.gle/chrome-for-testing) 118.0.5993.70 - [Puppeteer v21.4.0](https://github.com/puppeteer/puppeteer/blob/puppeteer-v21.4.0/docs/api/index.md) -- [Chrome for Testing](https://goo.gle/chrome-for-testing) 117.0.5938.149 - [Puppeteer v21.3.7](https://github.com/puppeteer/puppeteer/blob/puppeteer-v21.3.7/docs/api/index.md) -- [Chrome for Testing](https://goo.gle/chrome-for-testing) 117.0.5938.92 - [Puppeteer v21.3.2](https://github.com/puppeteer/puppeteer/blob/puppeteer-v21.3.2/docs/api/index.md) -- [Chrome for Testing](https://goo.gle/chrome-for-testing) 117.0.5938.62 - [Puppeteer v21.3.0](https://github.com/puppeteer/puppeteer/blob/puppeteer-v21.3.0/docs/api/index.md) -- [Chrome for Testing](https://goo.gle/chrome-for-testing) 116.0.5845.96 - [Puppeteer v21.1.0](https://github.com/puppeteer/puppeteer/blob/puppeteer-v21.1.0/docs/api/index.md) -- [Chrome for Testing](https://goo.gle/chrome-for-testing) 115.0.5790.170 - [Puppeteer v21.0.2](https://github.com/puppeteer/puppeteer/blob/puppeteer-v21.0.2/docs/api/index.md) -- [Chrome for Testing](https://goo.gle/chrome-for-testing) 115.0.5790.102 - [Puppeteer v21.0.0](https://github.com/puppeteer/puppeteer/blob/puppeteer-v21.0.0/docs/api/index.md) -- [Chrome for Testing](https://goo.gle/chrome-for-testing) 115.0.5790.98 - [Puppeteer v20.9.0](https://github.com/puppeteer/puppeteer/blob/puppeteer-v20.9.0/docs/api/index.md) -- [Chrome for Testing](https://goo.gle/chrome-for-testing) 114.0.5735.133 - [Puppeteer v20.7.2](https://github.com/puppeteer/puppeteer/blob/puppeteer-v20.7.2/docs/api/index.md) -- [Chrome for Testing](https://goo.gle/chrome-for-testing) 114.0.5735.90 - [Puppeteer v20.6.0](https://github.com/puppeteer/puppeteer/blob/puppeteer-v20.6.0/docs/api/index.md) -- [Chrome for Testing](https://goo.gle/chrome-for-testing) 113.0.5672.63 - [Puppeteer v20.1.0](https://github.com/puppeteer/puppeteer/blob/puppeteer-v20.1.0/docs/api/index.md) -- [Chrome for Testing](https://goo.gle/chrome-for-testing) 112.0.5615.121 - [Puppeteer v20.0.0](https://github.com/puppeteer/puppeteer/blob/puppeteer-v20.0.0/docs/api/index.md) +- [Chrome for Testing](https://developer.chrome.com/blog/chrome-for-testing/) 119.0.6045.105 - [Puppeteer v21.5.0](https://github.com/puppeteer/puppeteer/blob/puppeteer-v21.5.0/docs/api/index.md) +- [Chrome for Testing](https://developer.chrome.com/blog/chrome-for-testing/) 118.0.5993.70 - [Puppeteer v21.4.0](https://github.com/puppeteer/puppeteer/blob/puppeteer-v21.4.0/docs/api/index.md) +- [Chrome for Testing](https://developer.chrome.com/blog/chrome-for-testing/) 117.0.5938.149 - [Puppeteer v21.3.7](https://github.com/puppeteer/puppeteer/blob/puppeteer-v21.3.7/docs/api/index.md) +- [Chrome for Testing](https://developer.chrome.com/blog/chrome-for-testing/) 117.0.5938.92 - [Puppeteer v21.3.2](https://github.com/puppeteer/puppeteer/blob/puppeteer-v21.3.2/docs/api/index.md) +- [Chrome for Testing](https://developer.chrome.com/blog/chrome-for-testing/) 117.0.5938.62 - [Puppeteer v21.3.0](https://github.com/puppeteer/puppeteer/blob/puppeteer-v21.3.0/docs/api/index.md) +- [Chrome for Testing](https://developer.chrome.com/blog/chrome-for-testing/) 116.0.5845.96 - [Puppeteer v21.1.0](https://github.com/puppeteer/puppeteer/blob/puppeteer-v21.1.0/docs/api/index.md) +- [Chrome for Testing](https://developer.chrome.com/blog/chrome-for-testing/) 115.0.5790.170 - [Puppeteer v21.0.2](https://github.com/puppeteer/puppeteer/blob/puppeteer-v21.0.2/docs/api/index.md) +- [Chrome for Testing](https://developer.chrome.com/blog/chrome-for-testing/) 115.0.5790.102 - [Puppeteer v21.0.0](https://github.com/puppeteer/puppeteer/blob/puppeteer-v21.0.0/docs/api/index.md) +- [Chrome for Testing](https://developer.chrome.com/blog/chrome-for-testing/) 115.0.5790.98 - [Puppeteer v20.9.0](https://github.com/puppeteer/puppeteer/blob/puppeteer-v20.9.0/docs/api/index.md) +- [Chrome for Testing](https://developer.chrome.com/blog/chrome-for-testing/) 114.0.5735.133 - [Puppeteer v20.7.2](https://github.com/puppeteer/puppeteer/blob/puppeteer-v20.7.2/docs/api/index.md) +- [Chrome for Testing](https://developer.chrome.com/blog/chrome-for-testing/) 114.0.5735.90 - [Puppeteer v20.6.0](https://github.com/puppeteer/puppeteer/blob/puppeteer-v20.6.0/docs/api/index.md) +- [Chrome for Testing](https://developer.chrome.com/blog/chrome-for-testing/) 113.0.5672.63 - [Puppeteer v20.1.0](https://github.com/puppeteer/puppeteer/blob/puppeteer-v20.1.0/docs/api/index.md) +- [Chrome for Testing](https://developer.chrome.com/blog/chrome-for-testing/) 112.0.5615.121 - [Puppeteer v20.0.0](https://github.com/puppeteer/puppeteer/blob/puppeteer-v20.0.0/docs/api/index.md) - Chromium 112.0.5614.0 - [Puppeteer v19.8.0](https://github.com/puppeteer/puppeteer/blob/puppeteer-v19.8.0/docs/api/index.md) - Chromium 111.0.5556.0 - [Puppeteer v19.7.0](https://github.com/puppeteer/puppeteer/blob/puppeteer-v19.7.0/docs/api/index.md) - Chromium 110.0.5479.0 - [Puppeteer v19.6.0](https://github.com/puppeteer/puppeteer/blob/puppeteer-v19.6.0/docs/api/index.md) diff --git a/docs/faq.md b/docs/faq.md index 6b64cad7453..d4d48ac7896 100644 --- a/docs/faq.md +++ b/docs/faq.md @@ -2,7 +2,7 @@ ## Q: Who maintains Puppeteer? -The Chrome DevTools team maintains the library, but we'd love your help and +The Chrome Browser Automation team maintains the library, but we'd love your help and expertise on the project! See our [contributing guide](https://pptr.dev/contributing). @@ -31,12 +31,11 @@ non-standard DevTools Protocol used by Chrome). The goals of the project are: -- Provide a slim, canonical library that highlights the capabilities of the - [DevTools Protocol](https://chromedevtools.github.io/devtools-protocol/). -- Provide a reference implementation for similar testing libraries. Eventually, - these other frameworks could adopt Puppeteer as their foundational layer. -- Grow the adoption of headless/automated browser testing. -- Help dogfood new DevTools Protocol features...and catch bugs! +- Provide a reference implementation that highlights the capabilities of the + [Chrome DevTools](https://chromedevtools.github.io/devtools-protocol/) + and [WebDriver BiDi](https://w3c.github.io/webdriver-bidi/) protocols. +- Grow the adoption of automated cross-browser testing. +- Help dogfood new DevTools Protocol and WebDriver BiDi features...and catch bugs! - Learn more about the pain points of automated browser testing and help fill those gaps. @@ -46,36 +45,34 @@ help us drive product decisions: - **Speed**: Puppeteer has almost zero performance overhead over an automated page. -- **Security**: Puppeteer operates off-process with respect to Chromium, making +- **Security**: Puppeteer operates off-process with respect to the browser, making it safe to automate potentially malicious pages. - **Stability**: Puppeteer should not be flaky and should not leak memory. - **Simplicity**: Puppeteer provides a high-level API that’s easy to use, understand, and debug. -## Q: Is Puppeteer replacing Selenium/WebDriver? +## Q: Is Puppeteer a replacement for Selenium WebDriver? **No**. Both projects are valuable for very different reasons: -- Selenium/WebDriver focuses on cross-browser automation; its value proposition - is a single standard API that works across all major browsers. +- Selenium WebDriver focuses on cross-browser automation and provides bindings for + multiple languages; Puppeteer is only for JavaScript. - Puppeteer focuses on Chromium; its value proposition is richer functionality - and higher reliability. + for Chromium-based browsers. That said, you **can** use Puppeteer to run tests against Chromium, e.g. using the community-driven -[jest-puppeteer](https://github.com/smooth-code/jest-puppeteer). While this +[jest-puppeteer](https://github.com/smooth-code/jest-puppeteer) or +[Puppeteer's Angular integration](https://pptr.dev/integrations/ng-schematics). While this probably shouldn’t be your only testing solution, it does have a few good points -compared to WebDriver: +compared to WebDriver classic: -- Puppeteer requires zero setup and comes bundled with the Chromium version it +- Puppeteer requires zero setup and comes bundled with the Chrome version it works best with, making it [very easy to start with](https://github.com/puppeteer/puppeteer/#getting-started). - At the end of the day, it’s better to have a few tests running chromium-only, - than no tests at all. - Puppeteer has event-driven architecture, which removes a lot of potential - flakiness. There’s no need for evil “sleep(1000)” calls in puppeteer scripts. -- Puppeteer runs headless by default, which makes it fast to run. Puppeteer - v1.5.0 also exposes browser contexts, making it possible to efficiently + flakiness. There’s no need for “sleep(1000)” calls in puppeteer scripts. +- Puppeteer exposes browser contexts, making it possible to efficiently parallelize test execution. - Puppeteer shines when it comes to debugging: flip the “headless” bit to false, add “slowMo”, and you’ll see what the browser is doing. You can even open @@ -123,7 +120,7 @@ To download Firefox Nightly into an existing Puppeteer project: npx puppeteer browsers install firefox ``` -#### Q: What’s considered a “Navigation”? +## Q: What’s considered a “Navigation”? From Puppeteer’s standpoint, **“navigation” is anything that changes a page’s URL**. Aside from regular navigation where the browser hits the network to fetch @@ -135,7 +132,7 @@ usage. With this definition of “navigation,” **Puppeteer works seamlessly with single-page applications.** -#### Q: What’s the difference between a “trusted" and "untrusted" input event? +## Q: What’s the difference between a “trusted" and "untrusted" input event? In browsers, input events could be divided into two big groups: trusted vs. untrusted. @@ -165,38 +162,23 @@ await page.evaluate(() => { }); ``` -#### Q: What features does Puppeteer not support? +## Q: Does Puppeteer support media and audio playback? -You may find that Puppeteer does not behave as expected when controlling pages -that incorporate audio and video. (For example, -[video playback/screenshots is likely to fail](https://github.com/puppeteer/puppeteer/issues/291).) -There are two reasons for this: +Puppeteer uses [Chrome for Testing](https://developer.chrome.com/blog/chrome-for-testing/) binaries +by default which ship with properietary codecs support starting from +[M120](https://chromiumdash.appspot.com/commit/12d607016c31ea13579e897740c765be189ed6eb). -- Puppeteer is bundled with [Chrome for Testing](https://goo.gle/chrome-for-testing) — not the regular Chrome — and so by default, it - inherits all of - [Chromium's media-related limitations](https://www.chromium.org/audio-video). - This means that Puppeteer does not support licensed formats such as AAC or - H.264. (However, it is possible to force Puppeteer to use a - separately-installed version Chrome instead of Chromium via the - [`executablePath` option to `puppeteer.launch`](./api/puppeteer.launchoptions). - You should only use this configuration if you need an official release of - Chrome that supports these media formats.) -- Since Puppeteer (in all configurations) controls a desktop version of - Chromium/Chrome, features that are only supported by the mobile version of - Chrome are not supported. This means that Puppeteer - [does not support HTTP Live Streaming (HLS)](https://caniuse.com/#feat=http-live-streaming). - -#### Q: I am having trouble installing / running Puppeteer in my test environment. Where should I look for help? +## Q: I am having trouble installing / running Puppeteer in my test environment. Where should I look for help? We have a [troubleshooting](https://pptr.dev/troubleshooting) guide for various operating systems that lists the required dependencies. -#### Q: I have more questions! Where do I ask? +## Q: I have more questions! Where do I ask? There are many ways to get help on Puppeteer: -- [bugtracker](https://github.com/puppeteer/puppeteer/issues) -- [Stack Overflow](https://stackoverflow.com/questions/tagged/puppeteer) +- For questions: [Stack Overflow](https://stackoverflow.com/questions/tagged/puppeteer) +- For bug reports: [GitHub Issues](https://github.com/puppeteer/puppeteer/issues) Make sure to search these channels before posting your question. diff --git a/docs/guides/docker.md b/docs/guides/docker.md index 2391aacd546..266ddb5d3b2 100644 --- a/docs/guides/docker.md +++ b/docs/guides/docker.md @@ -1,6 +1,6 @@ # Docker -Puppeteer offers a Docker image that includes [Chrome for Testing](https://goo.gle/chrome-for-testing) along with the required +Puppeteer offers a Docker image that includes [Chrome for Testing](https://developer.chrome.com/blog/chrome-for-testing/) along with the required dependencies and a pre-installed Puppeteer version. The image is available via the [GitHub Container Registry](https://github.com/puppeteer/puppeteer/pkgs/container/puppeteer). diff --git a/docs/index.md b/docs/index.md index 3fc9c9df0fb..2f87f664314 100644 --- a/docs/index.md +++ b/docs/index.md @@ -46,7 +46,7 @@ pnpm i puppeteer ``` When you install Puppeteer, it automatically downloads a recent version of -[Chrome for Testing](https://goo.gle/chrome-for-testing) (~170MB macOS, ~282MB Linux, ~280MB Windows) that is [guaranteed to +[Chrome for Testing](https://developer.chrome.com/blog/chrome-for-testing/) (~170MB macOS, ~282MB Linux, ~280MB Windows) that is [guaranteed to work](https://pptr.dev/faq#q-why-doesnt-puppeteer-vxxx-work-with-chromium-vyyy) with Puppeteer. The browser is downloaded to the `$HOME/.cache/puppeteer` folder by default (starting with Puppeteer v19.0.0). diff --git a/packages/puppeteer-core/src/node/PuppeteerNode.ts b/packages/puppeteer-core/src/node/PuppeteerNode.ts index b03fc517e01..f6e3038e181 100644 --- a/packages/puppeteer-core/src/node/PuppeteerNode.ts +++ b/packages/puppeteer-core/src/node/PuppeteerNode.ts @@ -172,7 +172,7 @@ export class PuppeteerNode extends Puppeteer { * for a description of the differences between Chromium and Chrome. * {@link https://chromium.googlesource.com/chromium/src/+/lkgr/docs/chromium_browser_vs_google_chrome.md | This article} * describes some differences for Linux users. See - * {@link https://goo.gle/chrome-for-testing | this doc} for the description + * {@link https://developer.chrome.com/blog/chrome-for-testing/ | this doc} for the description * of Chrome for Testing. * * @param options - Options to configure launching behavior. diff --git a/website/versioned_docs/version-21.5.2/api/puppeteer.puppeteernode.launch.md b/website/versioned_docs/version-21.5.2/api/puppeteer.puppeteernode.launch.md index 4b1db660e55..78cae2896e9 100644 --- a/website/versioned_docs/version-21.5.2/api/puppeteer.puppeteernode.launch.md +++ b/website/versioned_docs/version-21.5.2/api/puppeteer.puppeteernode.launch.md @@ -28,7 +28,7 @@ Promise<[Browser](./puppeteer.browser.md)> ## Remarks -Puppeteer can also be used to control the Chrome browser, but it works best with the version of Chrome for Testing downloaded by default. There is no guarantee it will work with any other version. If Google Chrome (rather than Chrome for Testing) is preferred, a [Chrome Canary](https://www.google.com/chrome/browser/canary.html) or [Dev Channel](https://www.chromium.org/getting-involved/dev-channel) build is suggested. See [this article](https://www.howtogeek.com/202825/what%E2%80%99s-the-difference-between-chromium-and-chrome/) for a description of the differences between Chromium and Chrome. [This article](https://chromium.googlesource.com/chromium/src/+/lkgr/docs/chromium_browser_vs_google_chrome.md) describes some differences for Linux users. See [this doc](https://goo.gle/chrome-for-testing) for the description of Chrome for Testing. +Puppeteer can also be used to control the Chrome browser, but it works best with the version of Chrome for Testing downloaded by default. There is no guarantee it will work with any other version. If Google Chrome (rather than Chrome for Testing) is preferred, a [Chrome Canary](https://www.google.com/chrome/browser/canary.html) or [Dev Channel](https://www.chromium.org/getting-involved/dev-channel) build is suggested. See [this article](https://www.howtogeek.com/202825/what%E2%80%99s-the-difference-between-chromium-and-chrome/) for a description of the differences between Chromium and Chrome. [This article](https://chromium.googlesource.com/chromium/src/+/lkgr/docs/chromium_browser_vs_google_chrome.md) describes some differences for Linux users. See [this doc](https://developer.chrome.com/blog/chrome-for-testing/) for the description of Chrome for Testing. ## Example diff --git a/website/versioned_docs/version-21.5.2/chromium-support.md b/website/versioned_docs/version-21.5.2/chromium-support.md index baf3a1a96fa..e725ec942d6 100644 --- a/website/versioned_docs/version-21.5.2/chromium-support.md +++ b/website/versioned_docs/version-21.5.2/chromium-support.md @@ -4,19 +4,19 @@ The following versions of Chromium are supported, mapped to Puppeteer version: -- [Chrome for Testing](https://goo.gle/chrome-for-testing) 119.0.6045.105 - [Puppeteer v21.5.0](https://github.com/puppeteer/puppeteer/blob/puppeteer-v21.5.0/docs/api/index.md) -- [Chrome for Testing](https://goo.gle/chrome-for-testing) 118.0.5993.70 - [Puppeteer v21.4.0](https://github.com/puppeteer/puppeteer/blob/puppeteer-v21.4.0/docs/api/index.md) -- [Chrome for Testing](https://goo.gle/chrome-for-testing) 117.0.5938.149 - [Puppeteer v21.3.7](https://github.com/puppeteer/puppeteer/blob/puppeteer-v21.3.7/docs/api/index.md) -- [Chrome for Testing](https://goo.gle/chrome-for-testing) 117.0.5938.92 - [Puppeteer v21.3.2](https://github.com/puppeteer/puppeteer/blob/puppeteer-v21.3.2/docs/api/index.md) -- [Chrome for Testing](https://goo.gle/chrome-for-testing) 117.0.5938.62 - [Puppeteer v21.3.0](https://github.com/puppeteer/puppeteer/blob/puppeteer-v21.3.0/docs/api/index.md) -- [Chrome for Testing](https://goo.gle/chrome-for-testing) 116.0.5845.96 - [Puppeteer v21.1.0](https://github.com/puppeteer/puppeteer/blob/puppeteer-v21.1.0/docs/api/index.md) -- [Chrome for Testing](https://goo.gle/chrome-for-testing) 115.0.5790.170 - [Puppeteer v21.0.2](https://github.com/puppeteer/puppeteer/blob/puppeteer-v21.0.2/docs/api/index.md) -- [Chrome for Testing](https://goo.gle/chrome-for-testing) 115.0.5790.102 - [Puppeteer v21.0.0](https://github.com/puppeteer/puppeteer/blob/puppeteer-v21.0.0/docs/api/index.md) -- [Chrome for Testing](https://goo.gle/chrome-for-testing) 115.0.5790.98 - [Puppeteer v20.9.0](https://github.com/puppeteer/puppeteer/blob/puppeteer-v20.9.0/docs/api/index.md) -- [Chrome for Testing](https://goo.gle/chrome-for-testing) 114.0.5735.133 - [Puppeteer v20.7.2](https://github.com/puppeteer/puppeteer/blob/puppeteer-v20.7.2/docs/api/index.md) -- [Chrome for Testing](https://goo.gle/chrome-for-testing) 114.0.5735.90 - [Puppeteer v20.6.0](https://github.com/puppeteer/puppeteer/blob/puppeteer-v20.6.0/docs/api/index.md) -- [Chrome for Testing](https://goo.gle/chrome-for-testing) 113.0.5672.63 - [Puppeteer v20.1.0](https://github.com/puppeteer/puppeteer/blob/puppeteer-v20.1.0/docs/api/index.md) -- [Chrome for Testing](https://goo.gle/chrome-for-testing) 112.0.5615.121 - [Puppeteer v20.0.0](https://github.com/puppeteer/puppeteer/blob/puppeteer-v20.0.0/docs/api/index.md) +- [Chrome for Testing](https://developer.chrome.com/blog/chrome-for-testing/) 119.0.6045.105 - [Puppeteer v21.5.0](https://github.com/puppeteer/puppeteer/blob/puppeteer-v21.5.0/docs/api/index.md) +- [Chrome for Testing](https://developer.chrome.com/blog/chrome-for-testing/) 118.0.5993.70 - [Puppeteer v21.4.0](https://github.com/puppeteer/puppeteer/blob/puppeteer-v21.4.0/docs/api/index.md) +- [Chrome for Testing](https://developer.chrome.com/blog/chrome-for-testing/) 117.0.5938.149 - [Puppeteer v21.3.7](https://github.com/puppeteer/puppeteer/blob/puppeteer-v21.3.7/docs/api/index.md) +- [Chrome for Testing](https://developer.chrome.com/blog/chrome-for-testing/) 117.0.5938.92 - [Puppeteer v21.3.2](https://github.com/puppeteer/puppeteer/blob/puppeteer-v21.3.2/docs/api/index.md) +- [Chrome for Testing](https://developer.chrome.com/blog/chrome-for-testing/) 117.0.5938.62 - [Puppeteer v21.3.0](https://github.com/puppeteer/puppeteer/blob/puppeteer-v21.3.0/docs/api/index.md) +- [Chrome for Testing](https://developer.chrome.com/blog/chrome-for-testing/) 116.0.5845.96 - [Puppeteer v21.1.0](https://github.com/puppeteer/puppeteer/blob/puppeteer-v21.1.0/docs/api/index.md) +- [Chrome for Testing](https://developer.chrome.com/blog/chrome-for-testing/) 115.0.5790.170 - [Puppeteer v21.0.2](https://github.com/puppeteer/puppeteer/blob/puppeteer-v21.0.2/docs/api/index.md) +- [Chrome for Testing](https://developer.chrome.com/blog/chrome-for-testing/) 115.0.5790.102 - [Puppeteer v21.0.0](https://github.com/puppeteer/puppeteer/blob/puppeteer-v21.0.0/docs/api/index.md) +- [Chrome for Testing](https://developer.chrome.com/blog/chrome-for-testing/) 115.0.5790.98 - [Puppeteer v20.9.0](https://github.com/puppeteer/puppeteer/blob/puppeteer-v20.9.0/docs/api/index.md) +- [Chrome for Testing](https://developer.chrome.com/blog/chrome-for-testing/) 114.0.5735.133 - [Puppeteer v20.7.2](https://github.com/puppeteer/puppeteer/blob/puppeteer-v20.7.2/docs/api/index.md) +- [Chrome for Testing](https://developer.chrome.com/blog/chrome-for-testing/) 114.0.5735.90 - [Puppeteer v20.6.0](https://github.com/puppeteer/puppeteer/blob/puppeteer-v20.6.0/docs/api/index.md) +- [Chrome for Testing](https://developer.chrome.com/blog/chrome-for-testing/) 113.0.5672.63 - [Puppeteer v20.1.0](https://github.com/puppeteer/puppeteer/blob/puppeteer-v20.1.0/docs/api/index.md) +- [Chrome for Testing](https://developer.chrome.com/blog/chrome-for-testing/) 112.0.5615.121 - [Puppeteer v20.0.0](https://github.com/puppeteer/puppeteer/blob/puppeteer-v20.0.0/docs/api/index.md) - Chromium 112.0.5614.0 - [Puppeteer v19.8.0](https://github.com/puppeteer/puppeteer/blob/puppeteer-v19.8.0/docs/api/index.md) - Chromium 111.0.5556.0 - [Puppeteer v19.7.0](https://github.com/puppeteer/puppeteer/blob/puppeteer-v19.7.0/docs/api/index.md) - Chromium 110.0.5479.0 - [Puppeteer v19.6.0](https://github.com/puppeteer/puppeteer/blob/puppeteer-v19.6.0/docs/api/index.md) diff --git a/website/versioned_docs/version-21.5.2/faq.md b/website/versioned_docs/version-21.5.2/faq.md index a23efe9849e..1f7fa8bfc01 100644 --- a/website/versioned_docs/version-21.5.2/faq.md +++ b/website/versioned_docs/version-21.5.2/faq.md @@ -166,7 +166,7 @@ that incorporate audio and video. (For example, [video playback/screenshots is likely to fail](https://github.com/puppeteer/puppeteer/issues/291).) There are two reasons for this: -- Puppeteer is bundled with [Chrome for Testing](https://goo.gle/chrome-for-testing) — not the regular Chrome — and so by default, it +- Puppeteer is bundled with [Chrome for Testing](https://developer.chrome.com/blog/chrome-for-testing/) — not the regular Chrome — and so by default, it inherits all of [Chromium's media-related limitations](https://www.chromium.org/audio-video). This means that Puppeteer does not support licensed formats such as AAC or diff --git a/website/versioned_docs/version-21.5.2/guides/docker.md b/website/versioned_docs/version-21.5.2/guides/docker.md index 2391aacd546..266ddb5d3b2 100644 --- a/website/versioned_docs/version-21.5.2/guides/docker.md +++ b/website/versioned_docs/version-21.5.2/guides/docker.md @@ -1,6 +1,6 @@ # Docker -Puppeteer offers a Docker image that includes [Chrome for Testing](https://goo.gle/chrome-for-testing) along with the required +Puppeteer offers a Docker image that includes [Chrome for Testing](https://developer.chrome.com/blog/chrome-for-testing/) along with the required dependencies and a pre-installed Puppeteer version. The image is available via the [GitHub Container Registry](https://github.com/puppeteer/puppeteer/pkgs/container/puppeteer). diff --git a/website/versioned_docs/version-21.5.2/index.md b/website/versioned_docs/version-21.5.2/index.md index 3fc9c9df0fb..2f87f664314 100644 --- a/website/versioned_docs/version-21.5.2/index.md +++ b/website/versioned_docs/version-21.5.2/index.md @@ -46,7 +46,7 @@ pnpm i puppeteer ``` When you install Puppeteer, it automatically downloads a recent version of -[Chrome for Testing](https://goo.gle/chrome-for-testing) (~170MB macOS, ~282MB Linux, ~280MB Windows) that is [guaranteed to +[Chrome for Testing](https://developer.chrome.com/blog/chrome-for-testing/) (~170MB macOS, ~282MB Linux, ~280MB Windows) that is [guaranteed to work](https://pptr.dev/faq#q-why-doesnt-puppeteer-vxxx-work-with-chromium-vyyy) with Puppeteer. The browser is downloaded to the `$HOME/.cache/puppeteer` folder by default (starting with Puppeteer v19.0.0).