《刚刚问世》系列初窥篇-Java+Playwright自动化测试-12- iframe操作-上篇（详细教程）

qq5464642 · 2025-2-11 13:52:42

1.简介

原估计宏哥这里就不对iframe这个知识点做介绍和讲解了，因为前边的窗口切换就为这种网页处理提供了思路，另一个原因就是虽然iframe很强大，但是现在很少有网站用它了。但是还是有小伙伴或者童鞋们私下问这个问题，那么宏哥就单独写一篇关于iframe网页处理的文章。iframe 是web自动化里面一个比较头疼的测试场景，在Selenium中处理 iframe 需要切换来切换去非常麻烦。但是在playwright中，让其变得非常简单，我们在使用中无需切换iframe，直接定位元素即可。
2.iframe是什么

iframe就是我们常用的iframe标签：<iframe>。iframe标签是框架的一种形式，也比较常用到，iframe一般用来包含别的页面，例如我们可以在我们自己的网站页面加载别人网站或者本站其他页面的内容。iframe标签的最大作用就是让页面变得美观。iframe标签的用法有很多，主要区别在于对iframe标签定义的形式不同，例如定义iframe的长宽高。简单的一句话概括就是：iframe 就是HTML 中，用于网页嵌套网页的。一个网页可以嵌套到另一个网页中，可以嵌套很多层。和俄罗斯套娃差不多吧。
3.iframe语法

page.frame_locator()
locator = page.frame_locator("frame").get_by_text("登录");
说明：使用frame_locator() 定位到iframe上，再在上面使用locator方法定位元素。
可以使用page.frame_locator()或locator.frame_locator()方法创建 FrameLocator 捕获足该 iframe 中检索和定位元素。
使用示例一：
Locator locator = page.frameLocator("#my-frame").getByText("Submit");locator.click();
使用frame_locator() 定位到iframe上，然后继续在上面使用locator方法定位元素
iframe 定位器是严格的。这意味着如果有多个元素与给定的选择器匹配，则对 iframe 定位器的所有操作都会抛出异常。
// Throws if there are several frames in DOM:page.frame_locator(".result-frame").getByRole(AriaRole.BUTTON).click();// Works because we explicitly tell locator to pick the first frame:page.frame_locator(".result-frame").first().getByRole(AriaRole.BUTTON).click();
将 Locator 转换为 FrameLocator
如果你有一个指向的 Locator 对象，则可以使用 Locator.contentFrame（）将其转换为 FrameLocator。iframe
将 FrameLocator 转换为 Locator
如果你有一个 FrameLocator 对象，则可以使用 FrameLocator.owner（）将其转换为指向同一对象的 Locator。
4.FrameLocator定位

匹配第一个,将 locator 返回到第一个匹配的frame。
FrameLocator.first();
匹配最后一个
FrameLocator.last();
使用index索引
FrameLocator.nth(index);
获取全部iframes
page.frames
5.frame() 定位

一个页面可以附加一个或多个Frame对象。每个页面都有一个主框架，并且假设页面级交互（如单击）在主框架中操作。
页面可以附加带有iframe HTML标签的额外框架。可以访问这些帧以在帧内进行交互。
// Locate element inside frameLocator username = page.frameLocator(".frame-class").getByLabel("User Name");username.fill("John");
5.1frame对象

可以使用Page.frame（）API访问框架对象：
根据name属性和url属性匹配
// Get frame using the frame"s name attributeFrame frame = page.frame("frame-login");// Get frame using frame"s URLFrame frame = page.frameByUrl(Pattern.compile(".*domain.*"));// Interact with the frameframe.fill("#username-input", "John");
6.page.frame 和 page.frameLocator 区别

page.frameLocator() 返回的对象需要用locator() 方法定位元素，再操作元素
page.frame() 返回的对象可直接使用fill() 、 click() 方法。
7.项目实战

网上找了半天也没有找到这样的例子，以前百度、163的邮箱是这种。最近几年技术升级了，已经不是这种了。不找了索性宏哥自己在本地做一个这样的小demo给小伙伴或者童鞋们来演示一下。
7.1被测的HTML代码

1.准备测试练习index.html，如下：
<!DOCTYPE html><html><head> <title>北京-宏哥|iframeTestDemo</title> <style type="text/css"> .button1 { background-color: #f44336; border: none; color: white; padding: 15px 32px; text-align: center; text-decoration: none; display: inline-block; font-size: 28px; margin-bottom: 100px; text-decoration:none; color: white; } #myAnchor { text-decoration:none; color: white; } </style></head><body style="text-align:center"><div id="wrapper" style="position: relative;top: 100px;left:0px;"> <button class="button1"><a id="myAnchor" href="https://www.cnblogs.com/du-hong/">北京-宏哥</a></button></br> <div id="id1">I am a index page's div!</div> <input type="text" id="maininput" /> <br/> <iframe id="frameA" frameborder="0" scrolling="no" style="left:857px;position:absolute;" src="https://www.cnblogs.com/du-hong/p/iframe.html"></iframe></div></body></html>
2.准备测试练习iframe.html，如下：
<!DOCTYPE html><html><head> <title>I am a iframe!</title></head><body> <div id="div1">I am iframes div!</div> <input id="iframeinput"></input></body></html>
3.页面效果，如下图所示：

8.牛刀小试

8.1代码设计

8.2参考代码

package com.bjhg.playwright;import com.microsoft.playwright.Browser;import com.microsoft.playwright.BrowserContext;import com.microsoft.playwright.BrowserType;import com.microsoft.playwright.Locator;import com.microsoft.playwright.Page;import com.microsoft.playwright.Playwright;/** * @author 北京-宏哥 * * @公众号:北京宏哥（微信搜索，关注宏哥，提前解锁更多测试干货） * * 《刚刚问世》系列初窥篇-Java+Playwright自动化测试-12- iframe操作-上篇（详细教程） * * 2024年8月31日 */public class Test_frame { public static void main(String[] args) { try (Playwright playwright = Playwright.create()) { //1.使用chromium浏览器，# 浏览器配置，设置以GUI模式启动Chrome浏览器（要查看浏览器UI，在启动浏览器时传递 headless=false 标志。您还可以使用 slowMo 来减慢执行速度。 Browser browser = playwright.chromium().launch(new BrowserType.LaunchOptions().setHeadless(false).setSlowMo(3000)); //2.创建context BrowserContext context = browser.newContext(); //创建page Page page = context.newPage(); //3.浏览器打开百度 page.navigate("file:///E:/Desktop/test/iframe/index.html"); System.out.println(page.title()); // 操作非 iframe上的元素 page.locator("[id='maininput']").fill("I am a index page's div!"); // 操作 iframe 上的元素 Locator locator = page.frameLocator("#frameA").locator("[id='iframeinput']"); // xpath 匹配 locator.fill("This is a iframe input!"); System.out.println("Test Pass"); //关闭page page.close(); //关闭browser browser.close(); } }}
8.3运行代码

1.运行代码，右键Run As->Java Application，就可以看到控制台输出，如下图所示：

2.运行代码后电脑端的浏览器的动作（将对应文字输入输入框）。如下图所示：

9.小结

好了，时间不早了，今天就分享到这里，下一篇宏哥找一个还有iframe的在线网页给小伙伴或者童鞋们实战演示一下。

《刚刚问世》系列初窥篇-Java+Playwright自动化测试-12- iframe操作-上篇（详细教程）

《刚刚问世》系列初窥篇-Java+Playwright自动化测试-12- iframe操作-上篇（详细教程）

浏览过的版块