github/puppeteer
0
0
Fork 0
mirror of https://github.com/puppeteer/puppeteer synced 2024-06-14 14:02:48 +00:00
Code Issues Packages Projects Releases Wiki Activity

docs: update docs around gpu (#12052)

Browse Source
This commit is contained in:
Alex Rudenko 2024-03-07 11:23:08 +01:00 committed by GitHub
parent c25388c335
commit 5174f2b448
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
1 changed files with 20 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

27
docs/troubleshooting.md
View File

@ -1,11 +1,11 @@
# Troubleshooting # Troubleshooting
:::caution :::note
Chromium currently does not provide arm64 binaries for Linux. There are only To keep this page up-to-date we largely rely on community contributions.
binaries for Mac ARM. Please send a PR if you notice something is no longer up-to-date.
::: :::note
## `Cannot find module 'puppeteer-core/internal/...'` ## `Cannot find module 'puppeteer-core/internal/...'`
@ -78,6 +78,14 @@ common ones are provided below. Also, see
https://source.chromium.org/chromium/chromium/src/+/main:chrome/installer/linux/debian/dist_package_versions.json https://source.chromium.org/chromium/chromium/src/+/main:chrome/installer/linux/debian/dist_package_versions.json
for the up-to-date list of dependencies declared by the Chrome installer. for the up-to-date list of dependencies declared by the Chrome installer.
:::caution
Chrome currently does not provide arm64 binaries for Linux.
There are only arm64 binaries for Mac ARM.
That means that Linux binaries downloaded by default will not work on Linux arm64.
:::
<details> <details>
<summary>Debian (e.g. Ubuntu) Dependencies</summary> <summary>Debian (e.g. Ubuntu) Dependencies</summary>
@ -169,18 +177,23 @@ yum update nss -y
</details> </details>
## Chrome headless disables GPU compositing ## chrome-headless-shell disables GPU compositing
Chrome/Chromium requires `--enable-gpu` to chrome-headless-shell requires `--enable-gpu` to
[enable GPU acceleration in headless mode](https://crbug.com/1416283). [enable GPU acceleration in headless mode](https://crbug.com/1416283).
```ts ```ts
const browser = await puppeteer.launch({ const browser = await puppeteer.launch({
headless: true, headless: 'shell',
args: ['--enable-gpu'], args: ['--enable-gpu'],
}); });
``` ```
## Setting up GPU with Chrome
Generally, Chrome should be able to detect and enable GPU if the system has appropriate drivers.
For additional tips, see the following blog post https://developer.chrome.com/blog/supercharge-web-ai-testing.
## Setting Up Chrome Linux Sandbox ## Setting Up Chrome Linux Sandbox
In order to protect the host environment from untrusted web content, Chrome uses In order to protect the host environment from untrusted web content, Chrome uses