puppeteer/website/versioned_docs/version-22.8.1/api/puppeteer.page.waitforframe.md
release-please[bot] 042d61030c
chore: release main (#12415)
Co-authored-by: release-please[bot] <55107282+release-please[bot]@users.noreply.github.com>
2024-05-13 08:49:32 +00:00

71 lines
924 B
Markdown

---
sidebar_label: Page.waitForFrame
---
# Page.waitForFrame() method
Waits for a frame matching the given conditions to appear.
#### Signature:
```typescript
class Page {
waitForFrame(
urlOrPredicate: string | ((frame: Frame) => Awaitable<boolean>),
options?: WaitTimeoutOptions
): Promise<Frame>;
}
```
## Parameters
<table><thead><tr><th>
Parameter
</th><th>
Type
</th><th>
Description
</th></tr></thead>
<tbody><tr><td>
urlOrPredicate
</td><td>
string \| ((frame: [Frame](./puppeteer.frame.md)) =&gt; [Awaitable](./puppeteer.awaitable.md)&lt;boolean&gt;)
</td><td>
</td></tr>
<tr><td>
options
</td><td>
[WaitTimeoutOptions](./puppeteer.waittimeoutoptions.md)
</td><td>
_(Optional)_
</td></tr>
</tbody></table>
**Returns:**
Promise&lt;[Frame](./puppeteer.frame.md)&gt;
## Example
```ts
const frame = await page.waitForFrame(async frame => {
return frame.name() === 'Test';
});
```