mirror of
https://github.com/puppeteer/puppeteer
synced 2024-06-14 14:02:48 +00:00
refactor!: rename createIncognitoBrowserContext to createBrowserContext (#11834)
This commit is contained in:
parent
c63414dbb4
commit
46a3ef2681
@ -7,10 +7,10 @@ sidebar_label: API
|
|||||||
## Classes
|
## Classes
|
||||||
|
|
||||||
| Class | Description |
|
| Class | Description |
|
||||||
| --------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
| --------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||||
| [Accessibility](./puppeteer.accessibility.md) | The Accessibility class provides methods for inspecting the browser's accessibility tree. The accessibility tree is used by assistive technology such as [screen readers](https://en.wikipedia.org/wiki/Screen_reader) or [switches](https://en.wikipedia.org/wiki/Switch_access). |
|
| [Accessibility](./puppeteer.accessibility.md) | The Accessibility class provides methods for inspecting the browser's accessibility tree. The accessibility tree is used by assistive technology such as [screen readers](https://en.wikipedia.org/wiki/Screen_reader) or [switches](https://en.wikipedia.org/wiki/Switch_access). |
|
||||||
| [Browser](./puppeteer.browser.md) | <p>[Browser](./puppeteer.browser.md) represents a browser instance that is either:</p><p>- connected to via [Puppeteer.connect()](./puppeteer.puppeteer.connect.md) or - launched by [PuppeteerNode.launch()](./puppeteer.puppeteernode.launch.md).</p><p>[Browser](./puppeteer.browser.md) [emits](./puppeteer.eventemitter.md) various events which are documented in the [BrowserEvent](./puppeteer.browserevent.md) enum.</p> |
|
| [Browser](./puppeteer.browser.md) | <p>[Browser](./puppeteer.browser.md) represents a browser instance that is either:</p><p>- connected to via [Puppeteer.connect()](./puppeteer.puppeteer.connect.md) or - launched by [PuppeteerNode.launch()](./puppeteer.puppeteernode.launch.md).</p><p>[Browser](./puppeteer.browser.md) [emits](./puppeteer.eventemitter.md) various events which are documented in the [BrowserEvent](./puppeteer.browserevent.md) enum.</p> |
|
||||||
| [BrowserContext](./puppeteer.browsercontext.md) | <p>[BrowserContext](./puppeteer.browsercontext.md) represents individual sessions within a [browser](./puppeteer.browser.md).</p><p>When a [browser](./puppeteer.browser.md) is launched, it has a single [browser context](./puppeteer.browsercontext.md) by default. Others can be created using [Browser.createIncognitoBrowserContext()](./puppeteer.browser.createincognitobrowsercontext.md).</p><p>[BrowserContext](./puppeteer.browsercontext.md) [emits](./puppeteer.eventemitter.md) various events which are documented in the [BrowserContextEvent](./puppeteer.browsercontextevent.md) enum.</p><p>If a [page](./puppeteer.page.md) opens another [page](./puppeteer.page.md), e.g. using <code>window.open</code>, the popup will belong to the parent [page's browser context](./puppeteer.page.browsercontext.md).</p> |
|
| [BrowserContext](./puppeteer.browsercontext.md) | <p>[BrowserContext](./puppeteer.browsercontext.md) represents individual user contexts within a [browser](./puppeteer.browser.md).</p><p>When a [browser](./puppeteer.browser.md) is launched, it has a single [browser context](./puppeteer.browsercontext.md) by default. Others can be created using [Browser.createBrowserContext()](./puppeteer.browser.createbrowsercontext.md). Each context has isolated storage (cookies/localStorage/etc.)</p><p>[BrowserContext](./puppeteer.browsercontext.md) [emits](./puppeteer.eventemitter.md) various events which are documented in the [BrowserContextEvent](./puppeteer.browsercontextevent.md) enum.</p><p>If a [page](./puppeteer.page.md) opens another [page](./puppeteer.page.md), e.g. using <code>window.open</code>, the popup will belong to the parent [page's browser context](./puppeteer.page.browsercontext.md).</p> |
|
||||||
| [CDPSession](./puppeteer.cdpsession.md) | The <code>CDPSession</code> instances are used to talk raw Chrome Devtools Protocol. |
|
| [CDPSession](./puppeteer.cdpsession.md) | The <code>CDPSession</code> instances are used to talk raw Chrome Devtools Protocol. |
|
||||||
| [Connection](./puppeteer.connection.md) | |
|
| [Connection](./puppeteer.connection.md) | |
|
||||||
| [ConsoleMessage](./puppeteer.consolemessage.md) | ConsoleMessage objects are dispatched by page via the 'console' event. |
|
| [ConsoleMessage](./puppeteer.consolemessage.md) | ConsoleMessage objects are dispatched by page via the 'console' event. |
|
||||||
|
@ -1,10 +1,10 @@
|
|||||||
---
|
---
|
||||||
sidebar_label: Browser.createIncognitoBrowserContext
|
sidebar_label: Browser.createBrowserContext
|
||||||
---
|
---
|
||||||
|
|
||||||
# Browser.createIncognitoBrowserContext() method
|
# Browser.createBrowserContext() method
|
||||||
|
|
||||||
Creates a new incognito [browser context](./puppeteer.browsercontext.md).
|
Creates a new [browser context](./puppeteer.browsercontext.md).
|
||||||
|
|
||||||
This won't share cookies/cache with other [browser contexts](./puppeteer.browsercontext.md).
|
This won't share cookies/cache with other [browser contexts](./puppeteer.browsercontext.md).
|
||||||
|
|
||||||
@ -12,7 +12,7 @@ This won't share cookies/cache with other [browser contexts](./puppeteer.browser
|
|||||||
|
|
||||||
```typescript
|
```typescript
|
||||||
class Browser {
|
class Browser {
|
||||||
abstract createIncognitoBrowserContext(
|
abstract createBrowserContext(
|
||||||
options?: BrowserContextOptions
|
options?: BrowserContextOptions
|
||||||
): Promise<BrowserContext>;
|
): Promise<BrowserContext>;
|
||||||
}
|
}
|
||||||
@ -34,8 +34,8 @@ Promise<[BrowserContext](./puppeteer.browsercontext.md)>
|
|||||||
import puppeteer from 'puppeteer';
|
import puppeteer from 'puppeteer';
|
||||||
|
|
||||||
const browser = await puppeteer.launch();
|
const browser = await puppeteer.launch();
|
||||||
// Create a new incognito browser context.
|
// Create a new browser context.
|
||||||
const context = await browser.createIncognitoBrowserContext();
|
const context = await browser.createBrowserContext();
|
||||||
// Create a new page in a pristine context.
|
// Create a new page in a pristine context.
|
||||||
const page = await context.newPage();
|
const page = await context.newPage();
|
||||||
// Do stuff
|
// Do stuff
|
@ -64,10 +64,10 @@ await browser2.close();
|
|||||||
## Methods
|
## Methods
|
||||||
|
|
||||||
| Method | Modifiers | Description |
|
| Method | Modifiers | Description |
|
||||||
| ---------------------------------------------------------------------------------------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
| ---------------------------------------------------------------------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||||
| [browserContexts()](./puppeteer.browser.browsercontexts.md) | | <p>Gets a list of open [browser contexts](./puppeteer.browsercontext.md).</p><p>In a newly-created [browser](./puppeteer.browser.md), this will return a single instance of [BrowserContext](./puppeteer.browsercontext.md).</p> |
|
| [browserContexts()](./puppeteer.browser.browsercontexts.md) | | <p>Gets a list of open [browser contexts](./puppeteer.browsercontext.md).</p><p>In a newly-created [browser](./puppeteer.browser.md), this will return a single instance of [BrowserContext](./puppeteer.browsercontext.md).</p> |
|
||||||
| [close()](./puppeteer.browser.close.md) | | Closes this [browser](./puppeteer.browser.md) and all associated [pages](./puppeteer.page.md). |
|
| [close()](./puppeteer.browser.close.md) | | Closes this [browser](./puppeteer.browser.md) and all associated [pages](./puppeteer.page.md). |
|
||||||
| [createIncognitoBrowserContext(options)](./puppeteer.browser.createincognitobrowsercontext.md) | | <p>Creates a new incognito [browser context](./puppeteer.browsercontext.md).</p><p>This won't share cookies/cache with other [browser contexts](./puppeteer.browsercontext.md).</p> |
|
| [createBrowserContext(options)](./puppeteer.browser.createbrowsercontext.md) | | <p>Creates a new [browser context](./puppeteer.browsercontext.md).</p><p>This won't share cookies/cache with other [browser contexts](./puppeteer.browsercontext.md).</p> |
|
||||||
| [defaultBrowserContext()](./puppeteer.browser.defaultbrowsercontext.md) | | Gets the default [browser context](./puppeteer.browsercontext.md). |
|
| [defaultBrowserContext()](./puppeteer.browser.defaultbrowsercontext.md) | | Gets the default [browser context](./puppeteer.browsercontext.md). |
|
||||||
| [disconnect()](./puppeteer.browser.disconnect.md) | | Disconnects Puppeteer from this [browser](./puppeteer.browser.md), but leaves the process running. |
|
| [disconnect()](./puppeteer.browser.disconnect.md) | | Disconnects Puppeteer from this [browser](./puppeteer.browser.md), but leaves the process running. |
|
||||||
| [isConnected()](./puppeteer.browser.isconnected.md) | | Whether Puppeteer is connected to this [browser](./puppeteer.browser.md). |
|
| [isConnected()](./puppeteer.browser.isconnected.md) | | Whether Puppeteer is connected to this [browser](./puppeteer.browser.md). |
|
||||||
|
@ -6,7 +6,7 @@ sidebar_label: BrowserContext.isIncognito
|
|||||||
|
|
||||||
Whether this [browser context](./puppeteer.browsercontext.md) is incognito.
|
Whether this [browser context](./puppeteer.browsercontext.md) is incognito.
|
||||||
|
|
||||||
The [default browser context](./puppeteer.browser.defaultbrowsercontext.md) is the only non-incognito browser context.
|
In Chrome, the [default browser context](./puppeteer.browser.defaultbrowsercontext.md) is the only non-incognito browser context.
|
||||||
|
|
||||||
#### Signature:
|
#### Signature:
|
||||||
|
|
||||||
|
@ -4,9 +4,9 @@ sidebar_label: BrowserContext
|
|||||||
|
|
||||||
# BrowserContext class
|
# BrowserContext class
|
||||||
|
|
||||||
[BrowserContext](./puppeteer.browsercontext.md) represents individual sessions within a [browser](./puppeteer.browser.md).
|
[BrowserContext](./puppeteer.browsercontext.md) represents individual user contexts within a [browser](./puppeteer.browser.md).
|
||||||
|
|
||||||
When a [browser](./puppeteer.browser.md) is launched, it has a single [browser context](./puppeteer.browsercontext.md) by default. Others can be created using [Browser.createIncognitoBrowserContext()](./puppeteer.browser.createincognitobrowsercontext.md).
|
When a [browser](./puppeteer.browser.md) is launched, it has a single [browser context](./puppeteer.browsercontext.md) by default. Others can be created using [Browser.createBrowserContext()](./puppeteer.browser.createbrowsercontext.md). Each context has isolated storage (cookies/localStorage/etc.)
|
||||||
|
|
||||||
[BrowserContext](./puppeteer.browsercontext.md) [emits](./puppeteer.eventemitter.md) various events which are documented in the [BrowserContextEvent](./puppeteer.browsercontextevent.md) enum.
|
[BrowserContext](./puppeteer.browsercontext.md) [emits](./puppeteer.eventemitter.md) various events which are documented in the [BrowserContextEvent](./puppeteer.browsercontextevent.md) enum.
|
||||||
|
|
||||||
@ -26,11 +26,11 @@ The constructor for this class is marked as internal. Third-party code should no
|
|||||||
|
|
||||||
## Example
|
## Example
|
||||||
|
|
||||||
Creating an incognito [browser context](./puppeteer.browsercontext.md):
|
Creating a new [browser context](./puppeteer.browsercontext.md):
|
||||||
|
|
||||||
```ts
|
```ts
|
||||||
// Create a new incognito browser context
|
// Create a new browser context
|
||||||
const context = await browser.createIncognitoBrowserContext();
|
const context = await browser.createBrowserContext();
|
||||||
// Create a new page inside context.
|
// Create a new page inside context.
|
||||||
const page = await context.newPage();
|
const page = await context.newPage();
|
||||||
// ... do stuff with page ...
|
// ... do stuff with page ...
|
||||||
@ -49,11 +49,11 @@ await context.close();
|
|||||||
## Methods
|
## Methods
|
||||||
|
|
||||||
| Method | Modifiers | Description |
|
| Method | Modifiers | Description |
|
||||||
| --------------------------------------------------------------------------------------------- | --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
| --------------------------------------------------------------------------------------------- | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||||
| [browser()](./puppeteer.browsercontext.browser.md) | | Gets the [browser](./puppeteer.browser.md) associated with this [browser context](./puppeteer.browsercontext.md). |
|
| [browser()](./puppeteer.browsercontext.browser.md) | | Gets the [browser](./puppeteer.browser.md) associated with this [browser context](./puppeteer.browsercontext.md). |
|
||||||
| [clearPermissionOverrides()](./puppeteer.browsercontext.clearpermissionoverrides.md) | | Clears all permission overrides for this [browser context](./puppeteer.browsercontext.md). |
|
| [clearPermissionOverrides()](./puppeteer.browsercontext.clearpermissionoverrides.md) | | Clears all permission overrides for this [browser context](./puppeteer.browsercontext.md). |
|
||||||
| [close()](./puppeteer.browsercontext.close.md) | | Closes this [browser context](./puppeteer.browsercontext.md) and all associated [pages](./puppeteer.page.md). |
|
| [close()](./puppeteer.browsercontext.close.md) | | Closes this [browser context](./puppeteer.browsercontext.md) and all associated [pages](./puppeteer.page.md). |
|
||||||
| [isIncognito()](./puppeteer.browsercontext.isincognito.md) | | <p>Whether this [browser context](./puppeteer.browsercontext.md) is incognito.</p><p>The [default browser context](./puppeteer.browser.defaultbrowsercontext.md) is the only non-incognito browser context.</p> |
|
| [isIncognito()](./puppeteer.browsercontext.isincognito.md) | | <p>Whether this [browser context](./puppeteer.browsercontext.md) is incognito.</p><p>In Chrome, the [default browser context](./puppeteer.browser.defaultbrowsercontext.md) is the only non-incognito browser context.</p> |
|
||||||
| [newPage()](./puppeteer.browsercontext.newpage.md) | | Creates a new [page](./puppeteer.page.md) in this [browser context](./puppeteer.browsercontext.md). |
|
| [newPage()](./puppeteer.browsercontext.newpage.md) | | Creates a new [page](./puppeteer.page.md) in this [browser context](./puppeteer.browsercontext.md). |
|
||||||
| [overridePermissions(origin, permissions)](./puppeteer.browsercontext.overridepermissions.md) | | Grants this [browser context](./puppeteer.browsercontext.md) the given <code>permissions</code> within the given <code>origin</code>. |
|
| [overridePermissions(origin, permissions)](./puppeteer.browsercontext.overridepermissions.md) | | Grants this [browser context](./puppeteer.browsercontext.md) the given <code>permissions</code> within the given <code>origin</code>. |
|
||||||
| [pages()](./puppeteer.browsercontext.pages.md) | | Gets a list of all open [pages](./puppeteer.page.md) inside this [browser context](./puppeteer.browsercontext.md). |
|
| [pages()](./puppeteer.browsercontext.pages.md) | | Gets a list of all open [pages](./puppeteer.page.md) inside this [browser context](./puppeteer.browsercontext.md). |
|
||||||
|
@ -136,7 +136,7 @@ export const enum BrowserEvent {
|
|||||||
* Emitted when the URL of a target changes. Contains a {@link Target}
|
* Emitted when the URL of a target changes. Contains a {@link Target}
|
||||||
* instance.
|
* instance.
|
||||||
*
|
*
|
||||||
* @remarks Note that this includes target changes in incognito browser
|
* @remarks Note that this includes target changes in all browser
|
||||||
* contexts.
|
* contexts.
|
||||||
*/
|
*/
|
||||||
TargetChanged = 'targetchanged',
|
TargetChanged = 'targetchanged',
|
||||||
@ -147,7 +147,7 @@ export const enum BrowserEvent {
|
|||||||
*
|
*
|
||||||
* Contains a {@link Target} instance.
|
* Contains a {@link Target} instance.
|
||||||
*
|
*
|
||||||
* @remarks Note that this includes target creations in incognito browser
|
* @remarks Note that this includes target creations in all browser
|
||||||
* contexts.
|
* contexts.
|
||||||
*/
|
*/
|
||||||
TargetCreated = 'targetcreated',
|
TargetCreated = 'targetcreated',
|
||||||
@ -155,7 +155,7 @@ export const enum BrowserEvent {
|
|||||||
* Emitted when a target is destroyed, for example when a page is closed.
|
* Emitted when a target is destroyed, for example when a page is closed.
|
||||||
* Contains a {@link Target} instance.
|
* Contains a {@link Target} instance.
|
||||||
*
|
*
|
||||||
* @remarks Note that this includes target destructions in incognito browser
|
* @remarks Note that this includes target destructions in all browser
|
||||||
* contexts.
|
* contexts.
|
||||||
*/
|
*/
|
||||||
TargetDestroyed = 'targetdestroyed',
|
TargetDestroyed = 'targetdestroyed',
|
||||||
@ -244,7 +244,7 @@ export abstract class Browser extends EventEmitter<BrowserEvents> {
|
|||||||
abstract process(): ChildProcess | null;
|
abstract process(): ChildProcess | null;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Creates a new incognito {@link BrowserContext | browser context}.
|
* Creates a new {@link BrowserContext | browser context}.
|
||||||
*
|
*
|
||||||
* This won't share cookies/cache with other {@link BrowserContext | browser contexts}.
|
* This won't share cookies/cache with other {@link BrowserContext | browser contexts}.
|
||||||
*
|
*
|
||||||
@ -254,15 +254,15 @@ export abstract class Browser extends EventEmitter<BrowserEvents> {
|
|||||||
* import puppeteer from 'puppeteer';
|
* import puppeteer from 'puppeteer';
|
||||||
*
|
*
|
||||||
* const browser = await puppeteer.launch();
|
* const browser = await puppeteer.launch();
|
||||||
* // Create a new incognito browser context.
|
* // Create a new browser context.
|
||||||
* const context = await browser.createIncognitoBrowserContext();
|
* const context = await browser.createBrowserContext();
|
||||||
* // Create a new page in a pristine context.
|
* // Create a new page in a pristine context.
|
||||||
* const page = await context.newPage();
|
* const page = await context.newPage();
|
||||||
* // Do stuff
|
* // Do stuff
|
||||||
* await page.goto('https://example.com');
|
* await page.goto('https://example.com');
|
||||||
* ```
|
* ```
|
||||||
*/
|
*/
|
||||||
abstract createIncognitoBrowserContext(
|
abstract createBrowserContext(
|
||||||
options?: BrowserContextOptions
|
options?: BrowserContextOptions
|
||||||
): Promise<BrowserContext>;
|
): Promise<BrowserContext>;
|
||||||
|
|
||||||
|
@ -48,12 +48,13 @@ export interface BrowserContextEvents extends Record<EventType, unknown> {
|
|||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* {@link BrowserContext} represents individual sessions within a
|
* {@link BrowserContext} represents individual user contexts within a
|
||||||
* {@link Browser | browser}.
|
* {@link Browser | browser}.
|
||||||
*
|
*
|
||||||
* When a {@link Browser | browser} is launched, it has a single
|
* When a {@link Browser | browser} is launched, it has a single
|
||||||
* {@link BrowserContext | browser context} by default. Others can be created
|
* {@link BrowserContext | browser context} by default. Others can be created
|
||||||
* using {@link Browser.createIncognitoBrowserContext}.
|
* using {@link Browser.createBrowserContext}. Each context has isolated storage
|
||||||
|
* (cookies/localStorage/etc.)
|
||||||
*
|
*
|
||||||
* {@link BrowserContext} {@link EventEmitter | emits} various events which are
|
* {@link BrowserContext} {@link EventEmitter | emits} various events which are
|
||||||
* documented in the {@link BrowserContextEvent} enum.
|
* documented in the {@link BrowserContextEvent} enum.
|
||||||
@ -62,11 +63,11 @@ export interface BrowserContextEvents extends Record<EventType, unknown> {
|
|||||||
* `window.open`, the popup will belong to the parent {@link Page.browserContext
|
* `window.open`, the popup will belong to the parent {@link Page.browserContext
|
||||||
* | page's browser context}.
|
* | page's browser context}.
|
||||||
*
|
*
|
||||||
* @example Creating an incognito {@link BrowserContext | browser context}:
|
* @example Creating a new {@link BrowserContext | browser context}:
|
||||||
*
|
*
|
||||||
* ```ts
|
* ```ts
|
||||||
* // Create a new incognito browser context
|
* // Create a new browser context
|
||||||
* const context = await browser.createIncognitoBrowserContext();
|
* const context = await browser.createBrowserContext();
|
||||||
* // Create a new page inside context.
|
* // Create a new page inside context.
|
||||||
* const page = await context.newPage();
|
* const page = await context.newPage();
|
||||||
* // ... do stuff with page ...
|
* // ... do stuff with page ...
|
||||||
@ -124,8 +125,9 @@ export abstract class BrowserContext extends EventEmitter<BrowserContextEvents>
|
|||||||
/**
|
/**
|
||||||
* Whether this {@link BrowserContext | browser context} is incognito.
|
* Whether this {@link BrowserContext | browser context} is incognito.
|
||||||
*
|
*
|
||||||
* The {@link Browser.defaultBrowserContext | default browser context} is the
|
* In Chrome, the
|
||||||
* only non-incognito browser context.
|
* {@link Browser.defaultBrowserContext | default browser context} is the only
|
||||||
|
* non-incognito browser context.
|
||||||
*/
|
*/
|
||||||
abstract isIncognito(): boolean;
|
abstract isIncognito(): boolean;
|
||||||
|
|
||||||
|
@ -262,7 +262,7 @@ export class BidiBrowser extends Browser {
|
|||||||
return this.#process ?? null;
|
return this.#process ?? null;
|
||||||
}
|
}
|
||||||
|
|
||||||
override async createIncognitoBrowserContext(
|
override async createBrowserContext(
|
||||||
_options?: BrowserContextOptions
|
_options?: BrowserContextOptions
|
||||||
): Promise<BidiBrowserContext> {
|
): Promise<BidiBrowserContext> {
|
||||||
const userContext = await this.#browserCore.createUserContext();
|
const userContext = await this.#browserCore.createUserContext();
|
||||||
|
@ -201,7 +201,7 @@ export class CdpBrowser extends BrowserBase {
|
|||||||
return this.#isPageTargetCallback;
|
return this.#isPageTargetCallback;
|
||||||
}
|
}
|
||||||
|
|
||||||
override async createIncognitoBrowserContext(
|
override async createBrowserContext(
|
||||||
options: BrowserContextOptions = {}
|
options: BrowserContextOptions = {}
|
||||||
): Promise<CdpBrowserContext> {
|
): Promise<CdpBrowserContext> {
|
||||||
const {proxyServer, proxyBypassList} = options;
|
const {proxyServer, proxyBypassList} = options;
|
||||||
|
@ -34,7 +34,7 @@ describe('BrowserContext', function () {
|
|||||||
});
|
});
|
||||||
|
|
||||||
expect(browser.browserContexts()).toHaveLength(1);
|
expect(browser.browserContexts()).toHaveLength(1);
|
||||||
const context = await browser.createIncognitoBrowserContext();
|
const context = await browser.createBrowserContext();
|
||||||
expect(context.isIncognito()).toBe(true);
|
expect(context.isIncognito()).toBe(true);
|
||||||
expect(browser.browserContexts()).toHaveLength(2);
|
expect(browser.browserContexts()).toHaveLength(2);
|
||||||
expect(browser.browserContexts().indexOf(context) !== -1).toBe(true);
|
expect(browser.browserContexts().indexOf(context) !== -1).toBe(true);
|
||||||
@ -48,7 +48,7 @@ describe('BrowserContext', function () {
|
|||||||
|
|
||||||
expect(await browser.pages()).toHaveLength(1);
|
expect(await browser.pages()).toHaveLength(1);
|
||||||
|
|
||||||
const context = await browser.createIncognitoBrowserContext();
|
const context = await browser.createBrowserContext();
|
||||||
await context.newPage();
|
await context.newPage();
|
||||||
expect(await browser.pages()).toHaveLength(2);
|
expect(await browser.pages()).toHaveLength(2);
|
||||||
expect(await context.pages()).toHaveLength(1);
|
expect(await context.pages()).toHaveLength(1);
|
||||||
@ -128,7 +128,7 @@ describe('BrowserContext', function () {
|
|||||||
it('should timeout waiting for a non-existent target', async () => {
|
it('should timeout waiting for a non-existent target', async () => {
|
||||||
const {browser, server} = await getTestState();
|
const {browser, server} = await getTestState();
|
||||||
|
|
||||||
const context = await browser.createIncognitoBrowserContext();
|
const context = await browser.createBrowserContext();
|
||||||
const error = await context
|
const error = await context
|
||||||
.waitForTarget(
|
.waitForTarget(
|
||||||
target => {
|
target => {
|
||||||
@ -151,8 +151,8 @@ describe('BrowserContext', function () {
|
|||||||
});
|
});
|
||||||
|
|
||||||
// Create two incognito contexts.
|
// Create two incognito contexts.
|
||||||
const context1 = await browser.createIncognitoBrowserContext();
|
const context1 = await browser.createBrowserContext();
|
||||||
const context2 = await browser.createIncognitoBrowserContext();
|
const context2 = await browser.createBrowserContext();
|
||||||
expect(context1.targets()).toHaveLength(0);
|
expect(context1.targets()).toHaveLength(0);
|
||||||
expect(context2.targets()).toHaveLength(0);
|
expect(context2.targets()).toHaveLength(0);
|
||||||
|
|
||||||
@ -213,7 +213,7 @@ describe('BrowserContext', function () {
|
|||||||
});
|
});
|
||||||
|
|
||||||
expect(browser.browserContexts()).toHaveLength(1);
|
expect(browser.browserContexts()).toHaveLength(1);
|
||||||
const context = await browser.createIncognitoBrowserContext();
|
const context = await browser.createBrowserContext();
|
||||||
try {
|
try {
|
||||||
expect(browser.browserContexts()).toHaveLength(2);
|
expect(browser.browserContexts()).toHaveLength(2);
|
||||||
const remoteBrowser = await puppeteer.connect({
|
const remoteBrowser = await puppeteer.connect({
|
||||||
@ -236,7 +236,7 @@ describe('BrowserContext', function () {
|
|||||||
expect(browser.browserContexts()).toHaveLength(1);
|
expect(browser.browserContexts()).toHaveLength(1);
|
||||||
expect(browser.browserContexts()[0]!.id).toBeUndefined();
|
expect(browser.browserContexts()[0]!.id).toBeUndefined();
|
||||||
|
|
||||||
const context = await browser.createIncognitoBrowserContext();
|
const context = await browser.createBrowserContext();
|
||||||
expect(browser.browserContexts()).toHaveLength(2);
|
expect(browser.browserContexts()).toHaveLength(2);
|
||||||
expect(browser.browserContexts()[1]!.id).toBeDefined();
|
expect(browser.browserContexts()[1]!.id).toBeDefined();
|
||||||
await context.close();
|
await context.close();
|
||||||
@ -336,7 +336,7 @@ describe('BrowserContext', function () {
|
|||||||
const {page, server, context, browser} = await getTestState();
|
const {page, server, context, browser} = await getTestState();
|
||||||
|
|
||||||
await page.goto(server.EMPTY_PAGE);
|
await page.goto(server.EMPTY_PAGE);
|
||||||
const otherContext = await browser.createIncognitoBrowserContext();
|
const otherContext = await browser.createBrowserContext();
|
||||||
const otherPage = await otherContext.newPage();
|
const otherPage = await otherContext.newPage();
|
||||||
await otherPage.goto(server.EMPTY_PAGE);
|
await otherPage.goto(server.EMPTY_PAGE);
|
||||||
expect(await getPermission(page, 'geolocation')).toBe('prompt');
|
expect(await getPermission(page, 'geolocation')).toBe('prompt');
|
||||||
|
@ -93,7 +93,7 @@ describe('DevTools', function () {
|
|||||||
const browser = await launchBrowser(
|
const browser = await launchBrowser(
|
||||||
Object.assign({devtools: true}, launchOptions)
|
Object.assign({devtools: true}, launchOptions)
|
||||||
);
|
);
|
||||||
const context = await browser.createIncognitoBrowserContext();
|
const context = await browser.createBrowserContext();
|
||||||
await Promise.all([
|
await Promise.all([
|
||||||
context.newPage(),
|
context.newPage(),
|
||||||
browser.waitForTarget((target: {url: () => string | string[]}) => {
|
browser.waitForTarget((target: {url: () => string | string[]}) => {
|
||||||
@ -106,7 +106,7 @@ describe('DevTools', function () {
|
|||||||
const browser = await launchBrowser(
|
const browser = await launchBrowser(
|
||||||
Object.assign({devtools: true}, launchOptions)
|
Object.assign({devtools: true}, launchOptions)
|
||||||
);
|
);
|
||||||
const context = await browser.createIncognitoBrowserContext();
|
const context = await browser.createBrowserContext();
|
||||||
const [target] = await Promise.all([
|
const [target] = await Promise.all([
|
||||||
browser.waitForTarget((target: {url: () => string | string[]}) => {
|
browser.waitForTarget((target: {url: () => string | string[]}) => {
|
||||||
return target.url().includes('devtools://');
|
return target.url().includes('devtools://');
|
||||||
|
@ -224,7 +224,7 @@ describe('Cookie specs', () => {
|
|||||||
it('should isolate cookies in browser contexts', async () => {
|
it('should isolate cookies in browser contexts', async () => {
|
||||||
const {page, server, browser} = await getTestState();
|
const {page, server, browser} = await getTestState();
|
||||||
|
|
||||||
const anotherContext = await browser.createIncognitoBrowserContext();
|
const anotherContext = await browser.createBrowserContext();
|
||||||
const anotherPage = await anotherContext.newPage();
|
const anotherPage = await anotherContext.newPage();
|
||||||
|
|
||||||
await page.goto(server.EMPTY_PAGE);
|
await page.goto(server.EMPTY_PAGE);
|
||||||
|
@ -28,7 +28,7 @@ describe('device request prompt', function () {
|
|||||||
});
|
});
|
||||||
|
|
||||||
beforeEach(async () => {
|
beforeEach(async () => {
|
||||||
state.context = await state.browser.createIncognitoBrowserContext();
|
state.context = await state.browser.createBrowserContext();
|
||||||
state.page = await state.context.newPage();
|
state.page = await state.context.newPage();
|
||||||
});
|
});
|
||||||
|
|
||||||
|
@ -32,7 +32,7 @@ describe('ignoreHTTPSErrors', function () {
|
|||||||
});
|
});
|
||||||
|
|
||||||
beforeEach(async () => {
|
beforeEach(async () => {
|
||||||
state.context = await state.browser.createIncognitoBrowserContext();
|
state.context = await state.browser.createBrowserContext();
|
||||||
state.page = await state.context.newPage();
|
state.page = await state.context.newPage();
|
||||||
});
|
});
|
||||||
|
|
||||||
|
@ -216,7 +216,7 @@ export const getTestState = async (
|
|||||||
}
|
}
|
||||||
|
|
||||||
if (!skipContextCreation) {
|
if (!skipContextCreation) {
|
||||||
state.context = await state.browser!.createIncognitoBrowserContext();
|
state.context = await state.browser!.createBrowserContext();
|
||||||
state.page = await state.context.newPage();
|
state.page = await state.context.newPage();
|
||||||
}
|
}
|
||||||
return state as PuppeteerTestState;
|
return state as PuppeteerTestState;
|
||||||
@ -479,7 +479,7 @@ export const launch = async (
|
|||||||
let context: BrowserContext;
|
let context: BrowserContext;
|
||||||
let page: Page;
|
let page: Page;
|
||||||
if (createContext) {
|
if (createContext) {
|
||||||
context = await browser.createIncognitoBrowserContext();
|
context = await browser.createBrowserContext();
|
||||||
cleanupStorage.push(() => {
|
cleanupStorage.push(() => {
|
||||||
return context.close();
|
return context.close();
|
||||||
});
|
});
|
||||||
|
@ -33,7 +33,7 @@ describe('OOPIF', function () {
|
|||||||
});
|
});
|
||||||
|
|
||||||
beforeEach(async () => {
|
beforeEach(async () => {
|
||||||
state.context = await state.browser.createIncognitoBrowserContext();
|
state.context = await state.browser.createBrowserContext();
|
||||||
state.page = await state.context.newPage();
|
state.page = await state.context.newPage();
|
||||||
});
|
});
|
||||||
|
|
||||||
|
@ -150,7 +150,7 @@ describe('request proxy', () => {
|
|||||||
args: [...defaultArgs, `--proxy-server=${proxyServerUrl}`],
|
args: [...defaultArgs, `--proxy-server=${proxyServerUrl}`],
|
||||||
});
|
});
|
||||||
try {
|
try {
|
||||||
const context = await browser.createIncognitoBrowserContext();
|
const context = await browser.createBrowserContext();
|
||||||
const page = await context.newPage();
|
const page = await context.newPage();
|
||||||
const response = (await page.goto(emptyPageUrl))!;
|
const response = (await page.goto(emptyPageUrl))!;
|
||||||
|
|
||||||
@ -174,7 +174,7 @@ describe('request proxy', () => {
|
|||||||
],
|
],
|
||||||
});
|
});
|
||||||
try {
|
try {
|
||||||
const context = await browser.createIncognitoBrowserContext();
|
const context = await browser.createBrowserContext();
|
||||||
const page = await context.newPage();
|
const page = await context.newPage();
|
||||||
const response = (await page.goto(emptyPageUrl))!;
|
const response = (await page.goto(emptyPageUrl))!;
|
||||||
|
|
||||||
@ -197,7 +197,7 @@ describe('request proxy', () => {
|
|||||||
args: defaultArgs,
|
args: defaultArgs,
|
||||||
});
|
});
|
||||||
try {
|
try {
|
||||||
const context = await browser.createIncognitoBrowserContext({
|
const context = await browser.createBrowserContext({
|
||||||
proxyServer: proxyServerUrl,
|
proxyServer: proxyServerUrl,
|
||||||
});
|
});
|
||||||
const page = await context.newPage();
|
const page = await context.newPage();
|
||||||
@ -219,7 +219,7 @@ describe('request proxy', () => {
|
|||||||
args: defaultArgs,
|
args: defaultArgs,
|
||||||
});
|
});
|
||||||
try {
|
try {
|
||||||
const context = await browser.createIncognitoBrowserContext({
|
const context = await browser.createBrowserContext({
|
||||||
proxyServer: proxyServerUrl,
|
proxyServer: proxyServerUrl,
|
||||||
proxyBypassList: [new URL(emptyPageUrl).host],
|
proxyBypassList: [new URL(emptyPageUrl).host],
|
||||||
});
|
});
|
||||||
|
@ -361,7 +361,7 @@ describe('Screenshots', function () {
|
|||||||
it('should run in parallel in multiple pages', async () => {
|
it('should run in parallel in multiple pages', async () => {
|
||||||
const {browser, server} = await getTestState();
|
const {browser, server} = await getTestState();
|
||||||
|
|
||||||
const context = await browser.createIncognitoBrowserContext();
|
const context = await browser.createBrowserContext();
|
||||||
|
|
||||||
const N = 2;
|
const N = 2;
|
||||||
const pages = await Promise.all(
|
const pages = await Promise.all(
|
||||||
|
Loading…
Reference in New Issue
Block a user