puppeteer/website/versioned_docs/version-22.6.3/api/puppeteer.devicerequestprompt.md
release-please[bot] a63b8305ac
chore: release main (#12190)
Co-authored-by: release-please[bot] <55107282+release-please[bot]@users.noreply.github.com>
2024-04-05 13:11:52 +00:00

1.7 KiB

sidebar_label
DeviceRequestPrompt

DeviceRequestPrompt class

Device request prompts let you respond to the page requesting for a device through an API like WebBluetooth.

Signature:

export declare class DeviceRequestPrompt

Remarks

DeviceRequestPrompt instances are returned via the Page.waitForDevicePrompt() 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.

Example

const [deviceRequest] = Promise.all([
  page.waitForDevicePrompt(),
  page.click('#connect-bluetooth'),
]);
await devicePrompt.select(
  await devicePrompt.waitForDevice(({name}) => name.includes('My Device'))
);

Properties

Property

Modifiers

Type

Description

devices

DeviceRequestPromptDevice[]

Current list of selectable devices.

Methods

Method

Modifiers

Description

cancel()

Cancel the prompt.

select(device)

Select a device in the prompt's list.

waitForDevice(filter, options)

Resolve to the first device in the prompt matching a filter.