Frame methods, browser sessions serve 2, phone sessions 0 and computer sessions 2. A method marked not served answers StrategyUnavailable on that kind of session; check the handshake’s capabilities before relying on one.
Frame.getFrames
Browser: served
Phone: not served
Computer: served
Takes targetId
The tab’s frames, parents before children, cross-origin frames included.
| Field | Type | Description |
|---|---|---|
frames | FrameInfo[] |
Frame.waitForFrame
Browser: served
Phone: not served
Computer: served
Takes targetId
Wait for a frame matching urlContains, name and parentFrameId. With afterSeq, only frames attached after it count; without, an attached match answers at once. Fails with EventsExpired or ActionTimeout as Target.waitForTarget does.
| Param | Type | Required | Description |
|---|---|---|---|
urlContains | string | No | |
name | string | No | |
parentFrameId | string | No | |
afterSeq | integer | No | Only events after this event-log position count (a response’s seq). The log keeps each category for its own window (events: 1000 entries or 5 minutes; network records: 5000 entries or 2 minutes). One older than the window of the category the wait reads fails with EventsExpired; re-read state instead. |
timeoutMs | integer | No | Budget in milliseconds. 0 or omitted means 30000; at most 120000. Running out is ActionTimeout. |
| Field | Type | Description |
|---|---|---|
frameId | string | Opaque frame id for frameId on the envelope. |
parentFrameId | string | Absent for the main frame. |
targetId | string | Opaque tab id, stable while the tab is open. Never parse it. |
url | string | |
name | string | |
crossOrigin | boolean | The frame is from another origin than its parent. |