puppeteer/docs/api/puppeteer.browsercontext.overridepermissions.md

74 lines
1.1 KiB
Markdown
Raw Normal View History

2022-07-05 13:41:43 +00:00
---
sidebar_label: BrowserContext.overridePermissions
---
# BrowserContext.overridePermissions() method
Grants this [browser context](./puppeteer.browsercontext.md) the given `permissions` within the given `origin`.
#### Signature:
2022-07-05 13:41:43 +00:00
```typescript
class BrowserContext {
abstract overridePermissions(
origin: string,
permissions: Permission[]
): Promise<void>;
2022-07-05 13:41:43 +00:00
}
```
## Parameters
<table><thead><tr><th>
2022-07-05 13:41:43 +00:00
Parameter
</th><th>
Type
</th><th>
Description
</th></tr></thead>
<tbody><tr><td>
origin
</td><td>
string
</td><td>
The origin to grant permissions to, e.g. "https://example.com".
</td></tr>
<tr><td>
permissions
</td><td>
[Permission](./puppeteer.permission.md)\[\]
</td><td>
An array of permissions to grant. All permissions that are not listed here will be automatically denied.
</td></tr>
</tbody></table>
2022-07-05 13:41:43 +00:00
**Returns:**
Promise&lt;void&gt;
## Example
Overriding permissions in the [default browser context](./puppeteer.browser.defaultbrowsercontext.md):
2022-07-05 13:41:43 +00:00
```ts
const context = browser.defaultBrowserContext();
await context.overridePermissions('https://html5demos.com', ['geolocation']);
```