mirror of
https://github.com/puppeteer/puppeteer
synced 2024-06-14 14:02:48 +00:00
1fbc3c643f
This PR makes some improvements to the documentation. It migrates docker, debugging, and chrome extension documentation to the `guides` folder and also updates some of the terminology.
45 lines
1.2 KiB
Markdown
45 lines
1.2 KiB
Markdown
# Chrome Extensions
|
|
|
|
Puppeteer can be used for testing Chrome Extensions.
|
|
|
|
:::caution
|
|
|
|
Extensions in Chrome/Chromium currently only work in non-headless mode and experimental Chrome headless mode.
|
|
|
|
:::
|
|
|
|
The following is code for getting a handle to the [background page](https://developer.chrome.com/extensions/background_pages) of an extension whose source is located in `./my-extension`:
|
|
|
|
```ts
|
|
const puppeteer = require('puppeteer');
|
|
|
|
(async () => {
|
|
const pathToExtension = require('path').join(__dirname, 'my-extension');
|
|
const browser = await puppeteer.launch({
|
|
headless: 'chrome',
|
|
args: [
|
|
`--disable-extensions-except=${pathToExtension}`,
|
|
`--load-extension=${pathToExtension}`,
|
|
],
|
|
});
|
|
const backgroundPageTarget = await browser.waitForTarget(
|
|
target => target.type() === 'background_page'
|
|
);
|
|
const backgroundPage = await backgroundPageTarget.page();
|
|
// Test the background page as you would any other page.
|
|
await browser.close();
|
|
})();
|
|
```
|
|
|
|
:::note
|
|
|
|
Chrome Manifest V3 extensions have a background ServiceWorker of type 'service_worker', instead of a page of type 'background_page'.
|
|
|
|
:::
|
|
|
|
:::note
|
|
|
|
It is not yet possible to test extension popups or content scripts.
|
|
|
|
:::
|