mirror of
https://github.com/puppeteer/puppeteer
synced 2024-06-14 14:02:48 +00:00
chore(main): release 17.0.0 (#8828)
* chore(main): release 17.0.0 * chore: generate versioned docs Co-authored-by: release-please[bot] <55107282+release-please[bot]@users.noreply.github.com>
This commit is contained in:
release-please[bot]
GitHub
parent
1155c8eac8
commit
e2d9858b38
@ -1,3 +1,3 @@
|
||||
{
|
||||
".": "16.2.0"
|
||||
".": "17.0.0"
|
||||
}
|
||||
|
||||
15
CHANGELOG.md
15
CHANGELOG.md
@ -2,6 +2,21 @@
|
||||
|
||||
All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
|
||||
|
||||
## [17.0.0](https://github.com/puppeteer/puppeteer/compare/v16.2.0...v17.0.0) (2022-08-26)
|
||||
|
||||
|
||||
### ⚠ BREAKING CHANGES
|
||||
|
||||
* remove `root` from `WaitForSelectorOptions` (#8848)
|
||||
* internalize execution context (#8844)
|
||||
|
||||
### Bug Fixes
|
||||
|
||||
* allow multiple navigations to happen in LifecycleWatcher ([#8826](https://github.com/puppeteer/puppeteer/issues/8826)) ([341b669](https://github.com/puppeteer/puppeteer/commit/341b669a5e45ecbb9ffb0f28c45b520660f27ad2)), closes [#8811](https://github.com/puppeteer/puppeteer/issues/8811)
|
||||
* internalize execution context ([#8844](https://github.com/puppeteer/puppeteer/issues/8844)) ([2f33237](https://github.com/puppeteer/puppeteer/commit/2f33237d0443de77d58dca4454b0c9a1d2b57d03))
|
||||
* remove `root` from `WaitForSelectorOptions` ([#8848](https://github.com/puppeteer/puppeteer/issues/8848)) ([1155c8e](https://github.com/puppeteer/puppeteer/commit/1155c8eac85b176c3334cc3d98adfe7d943dfbe6))
|
||||
* remove deferred promise timeouts ([#8835](https://github.com/puppeteer/puppeteer/issues/8835)) ([202ffce](https://github.com/puppeteer/puppeteer/commit/202ffce0aa4f34dba35fbb8e7d740af16efee35f)), closes [#8832](https://github.com/puppeteer/puppeteer/issues/8832)
|
||||
|
||||
## [16.2.0](https://github.com/puppeteer/puppeteer/compare/v16.1.1...v16.2.0) (2022-08-18)
|
||||
|
||||
|
||||
|
||||
4
package-lock.json
generated
4
package-lock.json
generated
@ -1,12 +1,12 @@
|
||||
{
|
||||
"name": "puppeteer",
|
||||
"version": "16.2.0",
|
||||
"version": "17.0.0",
|
||||
"lockfileVersion": 2,
|
||||
"requires": true,
|
||||
"packages": {
|
||||
"": {
|
||||
"name": "puppeteer",
|
||||
"version": "16.2.0",
|
||||
"version": "17.0.0",
|
||||
"hasInstallScript": true,
|
||||
"license": "Apache-2.0",
|
||||
"dependencies": {
|
||||
|
||||
@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "puppeteer",
|
||||
"version": "16.2.0",
|
||||
"version": "17.0.0",
|
||||
"description": "A high-level API to control headless Chrome over the DevTools Protocol",
|
||||
"keywords": [
|
||||
"puppeteer",
|
||||
|
||||
@ -1,67 +0,0 @@
|
||||
---
|
||||
sidebar_label: ExecutionContext.evaluate
|
||||
---
|
||||
|
||||
# ExecutionContext.evaluate() method
|
||||
|
||||
Evaluates the given function.
|
||||
|
||||
**Signature:**
|
||||
|
||||
```typescript
|
||||
class ExecutionContext {
|
||||
evaluate<
|
||||
Params extends unknown[],
|
||||
Func extends EvaluateFunc<Params> = EvaluateFunc<Params>
|
||||
>(
|
||||
pageFunction: Func | string,
|
||||
...args: Params
|
||||
): Promise<Awaited<ReturnType<Func>>>;
|
||||
}
|
||||
```
|
||||
|
||||
## Parameters
|
||||
|
||||
| Parameter | Type | Description |
|
||||
| ------------ | -------------- | ----------------------------------------------- |
|
||||
| pageFunction | Func \| string | The function to evaluate. |
|
||||
| args | Params | Additional arguments to pass into the function. |
|
||||
|
||||
**Returns:**
|
||||
|
||||
Promise<Awaited<ReturnType<Func>>>
|
||||
|
||||
The result of evaluating the function. If the result is an object, a vanilla object containing the serializable properties of the result is returned.
|
||||
|
||||
## Example 1
|
||||
|
||||
```ts
|
||||
const executionContext = await page.mainFrame().executionContext();
|
||||
const result = await executionContext.evaluate(() => Promise.resolve(8 * 7))* ;
|
||||
console.log(result); // prints "56"
|
||||
```
|
||||
|
||||
## Example 2
|
||||
|
||||
A string can also be passed in instead of a function:
|
||||
|
||||
```ts
|
||||
console.log(await executionContext.evaluate('1 + 2')); // prints "3"
|
||||
```
|
||||
|
||||
## Example 3
|
||||
|
||||
Handles can also be passed as `args`. They resolve to their referenced object:
|
||||
|
||||
```ts
|
||||
const oneHandle = await executionContext.evaluateHandle(() => 1);
|
||||
const twoHandle = await executionContext.evaluateHandle(() => 2);
|
||||
const result = await executionContext.evaluate(
|
||||
(a, b) => a + b,
|
||||
oneHandle,
|
||||
twoHandle
|
||||
);
|
||||
await oneHandle.dispose();
|
||||
await twoHandle.dispose();
|
||||
console.log(result); // prints '3'.
|
||||
```
|
||||
@ -1,75 +0,0 @@
|
||||
---
|
||||
sidebar_label: ExecutionContext.evaluateHandle
|
||||
---
|
||||
|
||||
# ExecutionContext.evaluateHandle() method
|
||||
|
||||
Evaluates the given function.
|
||||
|
||||
Unlike [evaluate](./puppeteer.executioncontext.evaluate.md), this method returns a handle to the result of the function.
|
||||
|
||||
This method may be better suited if the object cannot be serialized (e.g. `Map`) and requires further manipulation.
|
||||
|
||||
**Signature:**
|
||||
|
||||
```typescript
|
||||
class ExecutionContext {
|
||||
evaluateHandle<
|
||||
Params extends unknown[],
|
||||
Func extends EvaluateFunc<Params> = EvaluateFunc<Params>
|
||||
>(
|
||||
pageFunction: Func | string,
|
||||
...args: Params
|
||||
): Promise<HandleFor<Awaited<ReturnType<Func>>>>;
|
||||
}
|
||||
```
|
||||
|
||||
## Parameters
|
||||
|
||||
| Parameter | Type | Description |
|
||||
| ------------ | -------------- | ----------------------------------------------- |
|
||||
| pageFunction | Func \| string | The function to evaluate. |
|
||||
| args | Params | Additional arguments to pass into the function. |
|
||||
|
||||
**Returns:**
|
||||
|
||||
Promise<[HandleFor](./puppeteer.handlefor.md)<Awaited<ReturnType<Func>>>>
|
||||
|
||||
A [handle](./puppeteer.jshandle.md) to the result of evaluating the function. If the result is a `Node`, then this will return an [element handle](./puppeteer.elementhandle.md).
|
||||
|
||||
## Example 1
|
||||
|
||||
```ts
|
||||
const context = await page.mainFrame().executionContext();
|
||||
const handle: JSHandle<typeof globalThis> = await context.evaluateHandle(() =>
|
||||
Promise.resolve(self)
|
||||
);
|
||||
```
|
||||
|
||||
## Example 2
|
||||
|
||||
A string can also be passed in instead of a function.
|
||||
|
||||
```ts
|
||||
const handle: JSHandle<number> = await context.evaluateHandle('1 + 2');
|
||||
```
|
||||
|
||||
## Example 3
|
||||
|
||||
Handles can also be passed as `args`. They resolve to their referenced object:
|
||||
|
||||
```ts
|
||||
const bodyHandle: ElementHandle<HTMLBodyElement> = await context.evaluateHandle(
|
||||
() => {
|
||||
return document.body;
|
||||
}
|
||||
);
|
||||
const stringHandle: JSHandle<string> = await context.evaluateHandle(
|
||||
body => body.innerHTML,
|
||||
body
|
||||
);
|
||||
console.log(await stringHandle.jsonValue()); // prints body's innerHTML
|
||||
// Always dispose your garbage! :)
|
||||
await bodyHandle.dispose();
|
||||
await stringHandle.dispose();
|
||||
```
|
||||
@ -1,23 +0,0 @@
|
||||
---
|
||||
sidebar_label: ExecutionContext.frame
|
||||
---
|
||||
|
||||
# ExecutionContext.frame() method
|
||||
|
||||
**Signature:**
|
||||
|
||||
```typescript
|
||||
class ExecutionContext {
|
||||
frame(): Frame | null;
|
||||
}
|
||||
```
|
||||
|
||||
**Returns:**
|
||||
|
||||
[Frame](./puppeteer.frame.md) \| null
|
||||
|
||||
The frame associated with this execution context.
|
||||
|
||||
## Remarks
|
||||
|
||||
Not every execution context is associated with a frame. For example, [workers](./puppeteer.webworker.md) have execution contexts that are not associated with frames.
|
||||
@ -1,38 +0,0 @@
|
||||
---
|
||||
sidebar_label: ExecutionContext
|
||||
---
|
||||
|
||||
# ExecutionContext class
|
||||
|
||||
> Warning: This API is now obsolete.
|
||||
>
|
||||
> Do not use directly.
|
||||
>
|
||||
> Represents a context for JavaScript execution.
|
||||
|
||||
**Signature:**
|
||||
|
||||
```typescript
|
||||
export declare class ExecutionContext
|
||||
```
|
||||
|
||||
## Remarks
|
||||
|
||||
Besides pages, execution contexts can be found in [workers](./puppeteer.webworker.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 `ExecutionContext` class.
|
||||
|
||||
## Example
|
||||
|
||||
A [Page](./puppeteer.page.md) can have several execution contexts:
|
||||
|
||||
- Each [Frame](./puppeteer.frame.md) of a [page](./puppeteer.page.md) has a "default" execution context that is always created after frame is attached to DOM. This context is returned by the [Frame.executionContext()](./puppeteer.frame.executioncontext.md) method. - Each [Chrome extensions](https://developer.chrome.com/extensions) creates additional execution contexts to isolate their code.
|
||||
|
||||
## Methods
|
||||
|
||||
| Method | Modifiers | Description |
|
||||
| ------------------------------------------------------------------------------------ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| [evaluate(pageFunction, args)](./puppeteer.executioncontext.evaluate.md) | | Evaluates the given function. |
|
||||
| [evaluateHandle(pageFunction, args)](./puppeteer.executioncontext.evaluatehandle.md) | | <p>Evaluates the given function.</p><p>Unlike [evaluate](./puppeteer.executioncontext.evaluate.md), this method returns a handle to the result of the function.</p><p>This method may be better suited if the object cannot be serialized (e.g. <code>Map</code>) and requires further manipulation.</p> |
|
||||
| [frame()](./puppeteer.executioncontext.frame.md) | | |
|
||||
| [queryObjects(prototypeHandle)](./puppeteer.executioncontext.queryobjects.md) | | Iterates through the JavaScript heap and finds all the objects with the given prototype. |
|
||||
@ -1,44 +0,0 @@
|
||||
---
|
||||
sidebar_label: ExecutionContext.queryObjects
|
||||
---
|
||||
|
||||
# ExecutionContext.queryObjects() method
|
||||
|
||||
Iterates through the JavaScript heap and finds all the objects with the given prototype.
|
||||
|
||||
**Signature:**
|
||||
|
||||
```typescript
|
||||
class ExecutionContext {
|
||||
queryObjects<Prototype>(
|
||||
prototypeHandle: JSHandle<Prototype>
|
||||
): Promise<HandleFor<Prototype[]>>;
|
||||
}
|
||||
```
|
||||
|
||||
## Parameters
|
||||
|
||||
| Parameter | Type | Description |
|
||||
| --------------- | ---------------------------------------------------- | -------------------------------- |
|
||||
| prototypeHandle | [JSHandle](./puppeteer.jshandle.md)<Prototype> | a handle to the object prototype |
|
||||
|
||||
**Returns:**
|
||||
|
||||
Promise<[HandleFor](./puppeteer.handlefor.md)<Prototype\[\]>>
|
||||
|
||||
A handle to an array of objects with the given prototype.
|
||||
|
||||
## Example
|
||||
|
||||
```ts
|
||||
// Create a Map object
|
||||
await page.evaluate(() => (window.map = new Map()));
|
||||
// Get a handle to the Map object prototype
|
||||
const mapPrototype = await page.evaluateHandle(() => Map.prototype);
|
||||
// Query all map instances into an array
|
||||
const mapInstances = await page.queryObjects(mapPrototype);
|
||||
// Count amount of map objects in heap
|
||||
const count = await page.evaluate(maps => maps.length, mapInstances);
|
||||
await mapInstances.dispose();
|
||||
await mapPrototype.dispose();
|
||||
```
|
||||
@ -1,23 +0,0 @@
|
||||
---
|
||||
sidebar_label: Frame.executionContext
|
||||
---
|
||||
|
||||
# Frame.executionContext() method
|
||||
|
||||
> Warning: This API is now obsolete.
|
||||
>
|
||||
> Do not use the execution context directly.
|
||||
|
||||
**Signature:**
|
||||
|
||||
```typescript
|
||||
class Frame {
|
||||
executionContext(): Promise<ExecutionContext>;
|
||||
}
|
||||
```
|
||||
|
||||
**Returns:**
|
||||
|
||||
Promise<[ExecutionContext](./puppeteer.executioncontext.md)>
|
||||
|
||||
a promise that resolves to the frame's default execution context.
|
||||
@ -1,19 +0,0 @@
|
||||
---
|
||||
sidebar_label: JSHandle.executionContext
|
||||
---
|
||||
|
||||
# JSHandle.executionContext() method
|
||||
|
||||
**Signature:**
|
||||
|
||||
```typescript
|
||||
class JSHandle {
|
||||
executionContext(): ExecutionContext;
|
||||
}
|
||||
```
|
||||
|
||||
**Returns:**
|
||||
|
||||
[ExecutionContext](./puppeteer.executioncontext.md)
|
||||
|
||||
The execution context the handle belongs to.
|
||||
@ -1,20 +0,0 @@
|
||||
---
|
||||
sidebar_label: WaitForSelectorOptions
|
||||
---
|
||||
|
||||
# WaitForSelectorOptions interface
|
||||
|
||||
**Signature:**
|
||||
|
||||
```typescript
|
||||
export interface WaitForSelectorOptions
|
||||
```
|
||||
|
||||
## Properties
|
||||
|
||||
| Property | Modifiers | Type | Description |
|
||||
| --------------------------------------------------------- | --------- | --------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
|
||||
| [hidden?](./puppeteer.waitforselectoroptions.hidden.md) | | boolean | <i>(Optional)</i> Wait for the selected element to not be found in the DOM or to be hidden, i.e. have <code>display: none</code> or <code>visibility: hidden</code> CSS properties. |
|
||||
| [root?](./puppeteer.waitforselectoroptions.root.md) | | [ElementHandle](./puppeteer.elementhandle.md)<Node> | <i>(Optional)</i> |
|
||||
| [timeout?](./puppeteer.waitforselectoroptions.timeout.md) | | number | <p><i>(Optional)</i> Maximum time to wait in milliseconds. Pass <code>0</code> to disable timeout.</p><p>The default value can be changed by using [Page.setDefaultTimeout()](./puppeteer.page.setdefaulttimeout.md)</p> |
|
||||
| [visible?](./puppeteer.waitforselectoroptions.visible.md) | | boolean | <i>(Optional)</i> Wait for the selected element to be present in DOM and to be visible, i.e. to not have <code>display: none</code> or <code>visibility: hidden</code> CSS properties. |
|
||||
@ -1,17 +0,0 @@
|
||||
---
|
||||
sidebar_label: WaitForSelectorOptions.root
|
||||
---
|
||||
|
||||
# WaitForSelectorOptions.root property
|
||||
|
||||
> Warning: This API is now obsolete.
|
||||
>
|
||||
> Do not use. Use the [ElementHandle.waitForSelector()](./puppeteer.elementhandle.waitforselector.md)
|
||||
|
||||
**Signature:**
|
||||
|
||||
```typescript
|
||||
interface WaitForSelectorOptions {
|
||||
root?: ElementHandle<Node>;
|
||||
}
|
||||
```
|
||||
@ -1,21 +0,0 @@
|
||||
---
|
||||
sidebar_label: WebWorker.executionContext
|
||||
---
|
||||
|
||||
# WebWorker.executionContext() method
|
||||
|
||||
Returns the ExecutionContext the WebWorker runs in
|
||||
|
||||
**Signature:**
|
||||
|
||||
```typescript
|
||||
class WebWorker {
|
||||
executionContext(): Promise<ExecutionContext>;
|
||||
}
|
||||
```
|
||||
|
||||
**Returns:**
|
||||
|
||||
Promise<[ExecutionContext](./puppeteer.executioncontext.md)>
|
||||
|
||||
The ExecutionContext the web worker runs in.
|
||||
@ -7,7 +7,7 @@ sidebar_label: API
|
||||
## Classes
|
||||
|
||||
| Class | Description |
|
||||
| --------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| ------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| [Accessibility](./puppeteer.accessibility.md) | The Accessibility class provides methods for inspecting Chromium'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) | A Browser is created when Puppeteer connects to a Chromium instance, either through [PuppeteerNode.launch()](./puppeteer.puppeteernode.launch.md) or [Puppeteer.connect()](./puppeteer.puppeteer.connect.md). |
|
||||
| [BrowserContext](./puppeteer.browsercontext.md) | BrowserContexts provide a way to operate multiple independent browser sessions. When a browser is launched, it has a single BrowserContext used by default. The method [Browser.newPage](./puppeteer.browser.newpage.md) creates a page in the default browser context. |
|
||||
@ -21,7 +21,6 @@ sidebar_label: API
|
||||
| [Dialog](./puppeteer.dialog.md) | Dialog instances are dispatched by the [Page](./puppeteer.page.md) via the <code>dialog</code> event. |
|
||||
| [ElementHandle](./puppeteer.elementhandle.md) | ElementHandle represents an in-page DOM element. |
|
||||
| [EventEmitter](./puppeteer.eventemitter.md) | The EventEmitter class that many Puppeteer classes extend. |
|
||||
| [ExecutionContext](./puppeteer.executioncontext.md) | |
|
||||
| [FileChooser](./puppeteer.filechooser.md) | File choosers let you react to the page requesting for a file. |
|
||||
| [Frame](./puppeteer.frame.md) | <p>Represents a DOM frame.</p><p>To understand frames, you can think of frames as <code><iframe></code> elements. Just like iframes, frames can be nested, and when JavaScript is executed in a frame, the JavaScript does not effect frames inside the ambient frame the JavaScript executes in.</p> |
|
||||
| [HTTPRequest](./puppeteer.httprequest.md) | Represents an HTTP request sent by a page. |
|
||||
Some files were not shown because too many files have changed in this diff Show More
Loading…
Reference in New Issue
Block a user