puppeteer/docs/api/puppeteer.page.queryobjects.md
jrandolf f07ad2c661
fix: update documentation on configuring puppeteer ()
This PR updates the docs regarding configuring puppeteer. In addition,
some changes have been made to the documentation generator to show
default values on the documentation site.

Also fixes: https://github.com/puppeteer/puppeteer/pull/9144
2022-10-24 09:07:05 +02:00

1.3 KiB

sidebar_label
Page.queryObjects

Page.queryObjects() method

This method iterates the JavaScript heap and finds all objects with the given prototype.

Signature:

class Page {
  queryObjects<Prototype>(
    prototypeHandle: JSHandle<Prototype>
  ): Promise<JSHandle<Prototype[]>>;
}

Parameters

Parameter Type Description
prototypeHandle JSHandle<Prototype> a handle to the object prototype.

Returns:

Promise<JSHandle<Prototype[]>>

Promise which resolves to a handle to an array of objects with this prototype.

Example

// 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();