mirror of
https://github.com/puppeteer/puppeteer
synced 2024-06-14 14:02:48 +00:00
e1a9b85bbe
Co-authored-by: release-please[bot] <55107282+release-please[bot]@users.noreply.github.com>
50 lines
1.2 KiB
Markdown
50 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
|
|
import puppeteer from 'puppeteer';
|
|
import path from 'path';
|
|
|
|
(async () => {
|
|
const pathToExtension = path.join(process.cwd(), 'my-extension');
|
|
const browser = await puppeteer.launch({
|
|
headless: 'new',
|
|
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.
|
|
|
|
:::
|