docs: added extensions page (#7010)

This commit is contained in:
Max Schmitt 2021-06-10 07:48:16 -07:00 committed by GitHub
parent 05382c997b
commit 54d5978026
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

29
docs/src/extensions.md Normal file
View File

@ -0,0 +1,29 @@
---
id: extensions
title: "Testing extensions"
---
:::note
Extensions only work in Chrome / Chromium in non-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`:
```js
const { chromium } = require('playwright');
(async () => {
const pathToExtension = require('path').join(__dirname, 'my-extension');
const userDataDir = '/tmp/test-user-data-dir';
const browserContext = await chromium.launchPersistentContext(userDataDir,{
headless: false,
args: [
`--disable-extensions-except=${pathToExtension}`,
`--load-extension=${pathToExtension}`
]
});
const backgroundPage = browserContext.backgroundPages()[0];
// Test the background page as you would any other page.
await browserContext.close();
})();
```