Class CdpBrowser
- Namespace
- PuppeteerSharp.Cdp
- Assembly
- PuppeteerSharp.dll
Supports all classes in the .NET class hierarchy and provides low-level services to derived classes. This is the ultimate base class of all .NET classes; it is the root of the type hierarchy.
public class CdpBrowser : Browser, IBrowser, IDisposable, IAsyncDisposable
- Inheritance
-
CdpBrowser
- Implements
Properties
IsClosed
Gets a value indicating if the browser is closed.
public override bool IsClosed { get; }
Property Value
Methods
BrowserContexts()
Returns an array of all open IBrowserContext. In a newly created browser, this will return a single instance of IBrowserContext.
public override IBrowserContext[] BrowserContexts()
Returns
- IBrowserContext[]
An array of IBrowserContext objects.
CloseAsync()
Closes Chromium and all of its pages (if any were opened). The browser object itself is considered disposed and cannot be used anymore.
public override Task CloseAsync()
Returns
- Task
Task.
CreateBrowserContextAsync(BrowserContextOptions)
Creates a new browser context. This won't share cookies/cache with other browser contexts.
public override Task<IBrowserContext> CreateBrowserContextAsync(BrowserContextOptions options = null)
Parameters
options
BrowserContextOptionsOptions.
Returns
- Task<IBrowserContext>
Task which resolves to a new IBrowserContext object.
Examples
using(var browser = await Puppeteer.LaunchAsync(new LaunchOptions()))
{
// Create a new browser context.
var context = await browser.CreateBrowserContextAsync();
// Create a new page in a pristine context.
var page = await context.NewPageAsync();
// Do stuff
await page.GoToAsync("https://example.com");
}
Disconnect()
Disconnects Puppeteer from the browser, but leaves the process running. After calling Disconnect(), the browser object is considered disposed and cannot be used anymore.
public override void Disconnect()
GetUserAgentAsync()
Gets the browser's original user agent.
public override Task<string> GetUserAgentAsync()
Returns
Remarks
Pages can override browser user agent with SetUserAgentAsync(string, UserAgentMetadata).
GetVersionAsync()
Gets the browser's version.
public override Task<string> GetVersionAsync()
Returns
- Task<string>
For headless Chromium, this is similar to
HeadlessChrome/61.0.3153.0
. For non-headless, this is similar toChrome/61.0.3153.0
.
Remarks
the format of GetVersionAsync() might change with future releases of Chromium.
NewPageAsync()
Creates a new page.
public override Task<IPage> NewPageAsync()
Returns
Targets()
Returns An Array of all active targets.
public override ITarget[] Targets()
Returns
- ITarget[]
An Array of all active targets.