Frame class

At every point of time, page exposes its current frame tree via the page.mainFrame and frame.childFrames methods.

Frame object's lifecycle is controlled by three events, dispatched on the page object:

• Page.onFrameAttached - fired when the frame gets attached to the page. A Frame can be attached to the page only once.
• Page.onFrameNavigated - fired when the frame commits navigation to a different URL.
• Page.onFrameDetached - fired when the frame gets detached from the page. A Frame can be detached from the page only once.

An example of dumping frame tree:

void dumpFrameTree(Frame frame, String indent) {
  print(indent + frame.url);
  for (var child in frame.childFrames) {
    dumpFrameTree(child, indent + '  ');
  }
}

var browser = await puppeteer.launch();
var page = await browser.newPage();
await page.goto('https://example.com');
dumpFrameTree(page.mainFrame, '');
await browser.close();

An example of getting text from an iframe element:

var frame = page.frames.firstWhere((frame) => frame.name == 'myframe');
var text = await frame.$eval('.selector', 'el => el.textContent');
print(text);