@@ -36,6 +46,10 @@ The Accessibility class provides methods for inspecting the browser's accessibil
[Browser](./puppeteer.browser.md) [emits](./puppeteer.eventemitter.emit.md) various events which are documented in the [BrowserEvent](./puppeteer.browserevent.md) enum.
+**Remarks:**
+
+The constructor for this class is marked as internal. Third-party code should not call the constructor directly or create subclasses that extend the `Browser` class.
+
@@ -51,6 +65,10 @@ When a [browser](./puppeteer.browser.md) is launched, it has a single [browser c
If a [page](./puppeteer.page.md) opens another [page](./puppeteer.page.md), e.g. using `window.open`, the popup will belong to the parent [page's browser context](./puppeteer.page.browsercontext.md).
+**Remarks:**
+
+The constructor for this class is marked as internal. Third-party code should not call the constructor directly or create subclasses that extend the `BrowserContext` class.
+
@@ -60,6 +78,14 @@ If a [page](./puppeteer.page.md) opens another [page](./puppeteer.page.md), e.g.
The `CDPSession` instances are used to talk raw Chrome Devtools Protocol.
+**Remarks:**
+
+Protocol methods can be called with [CDPSession.send()](./puppeteer.cdpsession.send.md) method and protocol events can be subscribed to with `CDPSession.on` method.
+
+Useful links: [DevTools Protocol Viewer](https://chromedevtools.github.io/devtools-protocol/) and [Getting Started with DevTools Protocol](https://github.com/aslushnikov/getting-started-with-cdp/blob/HEAD/README.md).
+
+The constructor for this class is marked as internal. Third-party code should not call the constructor directly or create subclasses that extend the `CDPSession` class.
+
@@ -85,6 +111,10 @@ ConsoleMessage objects are dispatched by page via the 'console' event.
The Coverage class provides methods to gather information about parts of JavaScript and CSS that were used by the page.
+**Remarks:**
+
+To output coverage in a form consumable by [Istanbul](https://github.com/istanbuljs), see [puppeteer-to-istanbul](https://github.com/istanbuljs/puppeteer-to-istanbul).
+
@@ -101,6 +131,12 @@ The Coverage class provides methods to gather information about parts of JavaScr
Device request prompts let you respond to the page requesting for a device through an API like WebBluetooth.
+**Remarks:**
+
+`DeviceRequestPrompt` instances are returned via the [Page.waitForDevicePrompt()](./puppeteer.page.waitfordeviceprompt.md) method.
+
+The constructor for this class is marked as internal. Third-party code should not call the constructor directly or create subclasses that extend the `DeviceRequestPrompt` class.
+
@@ -110,6 +146,10 @@ Device request prompts let you respond to the page requesting for a device throu
Device in a request prompt.
+**Remarks:**
+
+The constructor for this class is marked as internal. Third-party code should not call the constructor directly or create subclasses that extend the `DeviceRequestPromptDevice` class.
+
@@ -119,6 +159,10 @@ Device in a request prompt.
Dialog instances are dispatched by the [Page](./puppeteer.page.md) via the `dialog` event.
+**Remarks:**
+
+The constructor for this class is marked as internal. Third-party code should not call the constructor directly or create subclasses that extend the `Dialog` class.
+
@@ -128,6 +172,31 @@ Dialog instances are dispatched by the [Page](./puppeteer.page.md) via the `dial
ElementHandle represents an in-page DOM element.
+**Remarks:**
+
+ElementHandles can be created with the [Page.$()](./puppeteer.page._.md) method.
+
+```ts
+import puppeteer from 'puppeteer';
+
+(async () => {
+ const browser = await puppeteer.launch();
+ const page = await browser.newPage();
+ await page.goto('https://example.com');
+ const hrefElement = await page.$('a');
+ await hrefElement.click();
+ // ...
+})();
+```
+
+ElementHandle prevents the DOM element from being garbage-collected unless the handle is [disposed](./puppeteer.jshandle.dispose.md). ElementHandles are auto-disposed when their origin frame gets navigated.
+
+ElementHandle instances can be used as arguments in [Page.$eval()](./puppeteer.page._eval.md) and [Page.evaluate()](./puppeteer.page.evaluate.md) methods.
+
+If you're using TypeScript, ElementHandle takes a generic argument that denotes the type of element the handle is holding within. For example, if you have a handle to a `
@@ -137,6 +206,12 @@ ElementHandle represents an in-page DOM element.
The EventEmitter class that many Puppeteer classes extend.
+**Remarks:**
+
+This allows you to listen to events that Puppeteer classes fire and act accordingly. Therefore you'll mostly use [on](./puppeteer.eventemitter.on.md) and [off](./puppeteer.eventemitter.off.md) to bind and unbind to event listeners.
+
+The constructor for this class is marked as internal. Third-party code should not call the constructor directly or create subclasses that extend the `EventEmitter` class.
+
@@ -146,6 +221,14 @@ The EventEmitter class that many Puppeteer classes extend.
File choosers let you react to the page requesting for a file.
+**Remarks:**
+
+`FileChooser` instances are returned via the [Page.waitForFileChooser()](./puppeteer.page.waitforfilechooser.md) method.
+
+In browsers, only one file chooser can be opened at a time. All file choosers must be accepted or canceled. Not doing so will prevent subsequent file choosers from appearing.
+
+The constructor for this class is marked as internal. Third-party code should not call the constructor directly or create subclasses that extend the `FileChooser` class.
+
@@ -157,6 +240,14 @@ Represents a DOM frame.
To understand frames, you can think of frames as `