seanyang_的博客

介绍Playwright 提供 API 来和浏览器网络流量，包括 HTTP 和 HTTPS。页面执行的任何请求，包括和请求，都可以被跟踪、修改和处理。模拟接口查看我们的，了解有关如何HTTP身份验证执行 HTTP 身份验证。同步HTTP 代理您可以将页面配置为通过 HTTP（S） 代理或 SOCKSv5 加载。可以为整个浏览器全局设置代理，也可以为每个浏览器上下文单独设置代理。您可以选择为 HTTP（S） 代理指定用户名和密码，也可以指定要绕过代理的主机。下面是全局代理的示例：同步。

剧作家可以为页面 DOM 元素或页面内的任何其他对象创建句柄。这些句柄存在于 Playwright 进程中，而实际对象位于浏览器中。由于页面中的任何 DOM 元素也是 JavaScript 对象，因此任何也是。句柄用于对页面中的这些实际对象执行操作。可以在句柄上求值、获取句柄属性、将句柄作为求值参数传递、将页面对象序列化为 JSON 等。有关这些和方法，请参阅类 API。元素句柄不鼓励使用，请改用对象和 Web 优先断言。当需要时，建议使用 page.wait_for_selector（） 或。

playwright可以进行API测试可以通过网络发送各种HTTP（S）请求。以下示例演示如何使用 Playwright 通过测试问题创建。

在 Playwright 中，`CDPSession` 类是用于与浏览器的 Chrome DevTools Protocol (CDP) 会话进行交互的对象。CDP 是与Chromium浏览器通信的底层协议，它提供了许多与浏览器进行交互和控制的功能。`CDPSession` 类提供了执行底层 CDP 命令的方法，并允许您监视和处理与浏览器相关的事件。您可以使用 `CDPSession` 类来执行高级的浏览器操作，例如截取网络请求、检索性能数据、模拟设备等。

在Playwright中，`Route`类用于捕获和修改请求和响应。它允许您拦截和处理特定的网络请求，以模拟不同的行为或进行自定义操作。您可以使用`page.route()`方法创建`Route`对象，并指定要拦截的请求URL或使用正则表达式进行匹配。一旦创建了`Route`对象，您可以通过调用`route.continue()`、`route.fulfill()`或`route.abort()`来控制请求的进一步处理。

定位器是playwright自动等待和重试能力的核心部分，代表了一种随时在页面上查找元素的方法。

Keyboard对象提供api管理虚拟的键盘，高级别的接口是keyboard.type()，并且接受keydown，keypress,input，keyup事件。

在 Playwright 中，JSHandle是一个表示浏览器中 JavaScript 对象的类。它提供了与网页中的 JavaScript 对象进行交互和操作的方法。可以通过调用 Playwright中的或evaluate方法来获取使用方法在页面上下文中执行 JavaScript 代码，并将结果返回一个JSHandle对象。最后，通过json_value方法获取JSHandle对象的文本值。

FileChooser对象通过page.on("filechoose")事件监听。如下代码实现点击百度搜图按钮，上传文件进行搜索。

consoleMessage对象可以通过page.on("console")事件进行监听。如当监听到F12控制台消息时，会调用on_console_message函数来打印消息。

Playwright Trace Viewer 是一个 GUI 工具，可帮助您在脚本运行后探索记录的 Playwright 跟踪。可以本地打开，也可以在.打开，

playwright 框架可以监听dialog事件，不管你alert 什么时候弹出来，监听到事件就自动处理了。当出现 JavaScript 对话框时发出，例如alert、prompt或。侦听器必须dialog.accept()或dialog.dismiss()对话框 - 否则页面将冻结等待对话框，并且单击等操作将永远不会完成。示例：html页面如下如下代码打开html页面，点击click me按钮，并接受confirm弹框，因为运行太快，我这里生成了一个trace文件，可以查看执行过程。

使用这两个方法，可以生成跟踪文件，跟踪文件可以在 Chrome 开发人员工具性能面板中打开。，则需要先关闭浏览器山下文browser_context.close（），再关闭浏览器。创建浏览器，则使用该方法可以关闭浏览器及其所有页面（如果打开了任何页面），如果使用。获取浏览器所属的浏览器类型（chromium，Firefox或webkit）。返回所有打开的浏览器上下文的数组。在新创建的浏览器中，这将返回零个浏览器上下文。创建新的浏览器上下文。该文件可以在浏览器开发者工具的性能面板中打开。

类提供了断言方法，可用于在测试中对进行断言。

playwright支持进行API测试playwright.request 方法返回APIRequest类型。

可以使用测试生成器通过仿真生成测试，以便为特定窗口、设备、配色方案生成测试，以及模拟地理位置、语言或时区。测试生成器还可以生成测试，同时保留经过身份验证的状态。模拟视口大小Playwright 打开一个浏览器窗口，其视口设置为特定的宽度和高度，并且没有响应，因为测试需要在相同的条件下运行。使用该选项生成具有不同视口大小的测试。模拟设备使用设置视口大小和用户代理等的选项在模拟移动设备时记录脚本和测试。模拟配色方案记录脚本和测试，同时使用该选项模拟配色方案。

运行命令并在浏览器窗口中执行操作。Playwright将为用户交互生成代码，可以在Playwright Inspector窗口中看到这些代码。完成测试记录后，点击record停止录制并按。运行该命令时，将打开两个窗口，一个浏览器窗口，可以在其中与要测试的网站进行交互，另一个是Playwright Inspector窗口，可以在其中记录测试，然后将其复制到编辑器中。使用该命令运行测试生成器，后面为要为其生成测试的网站的 URL。按钮将生成的测试复制到编辑器中。

可以附加一个或多个对象。每个页面都有一个主框架，并且假定页面级交互（如）在主框架中运行。click。

Playwright允许收听网页上发生的各种类型的事件，例如网络请求，创建子页面，专用工作人员等。有几种方法可以订阅此类事件，例如等待事件或添加或删除事件侦听器。

page.evaluate()方法接收一个参数，这个参数可以can be a mix of Serializable values and JSHandle or ElementHandle instances。API 可以在网页上下文中运行 JavaScript 函数，并将结果带回 Playwright 环境。

模拟接口模拟接口介绍Web API 通常作为 HTTP 终结点实现。Playwright提供了API来和网络流量，包括HTTP和HTTPS。页面所做的任何请求，包括和请求，都可以被跟踪、修改和模拟。使用Playwright，您还可以使用包含页面发出的多个网络请求的HAR文件进行模拟。模拟 API 请求以下代码将截获所有调用，并改为返回自定义响应。不会向 API 发出任何请求。测试将转到使用模拟路由的 URL，并断言页面上存在模拟数据。如下代码，handle会改变route的返回数据。

在进行测试的时候，我们可能在多个环境进行测试，每个环境的base_url是不一样的。

playwright可以导航到 URL 并处理由页面交互引起的导航。

​测试隔离是指每个测试与另一个测试完全隔离。每个测试都独立于任何其他测试运行。这意味着每个测试都有自己的本地存储、会话存储、cookie 等。Playwright使用来实现这一点，它相当于类似隐身的配置文件。它们创建起来既快速又便宜，并且是完全隔离的，即使在单个浏览器中运行时也是如此。Playwright 为每个测试创建一个上下文，并在该上下文中提供一个默认页面。

默认情况下，playwright以无头模式运行浏览器。若要更改此行为，请用作启动选项。还可以使用该选项减慢执行速度（每个操作减慢 N 毫秒），并在调试时执行。

使用playwright，您可以录制测试视频。

可将页面截图保存为screen.png屏幕截图API接受图像格式，剪辑区域，质量等的许多参数。请务必检查它们。

对于页面下载的每个附件，都会发出事件。下载开始后，将发出下载事件。下载完成后，下载路径将变为可用所有这些附件都下载到一个临时文件夹中。可以使用事件中的下载对象获取URL、文件系统路径和有效负载流。关闭浏览器上下文时，将删除属于浏览器上下文的所有下载文件。

每个版本的 Playwright 都需要特定版本的浏览器二进制文件才能运行。需要使用 Playwright CLI 来安装这些浏览器。对于每个版本，Playwright 都会更新其支持的浏览器版本，以便最新的 Playwright 随时支持最新的浏览器。这意味着每次更新 Playwright 时，都可能需要重新运行 CLI 命令。安装浏览器运行不带参数的命令将安装默认浏览器。指定浏览器运行。

测试可以加载现有的经过身份验证的状态。这消除了在每次测试中进行身份验证的需要，并加快了测试执行速度。会话存储特定于特定域，不会在页面加载期间持久化。Playwright 不提供用于持久保存会话存储的 API，但以下代码片段可用于保存/加载会话存储。Web 应用使用基于 Cookie 或基于令牌的身份验证，其中经过身份验证的状态存储为。为每个测试重做登录可能会减慢测试执行速度。从state.json获取cookie，在创建上下文时使用该cookie进行登录。执行可以看到，打开浏览器后，已经登录了。

可以为全局断言或按断言指定自定义超时。默认超时为 5 秒。元素具有 JavaScript 属性。元素具有 DOM 属性。元素具有 CSS 属性。列表包含确切的孩子数。响应具有“正常”状态。

在采取行动之前对元素执行一系列可操作性检查，以确保这些动作按预期运行。它会自动等待所有相关检查通过，然后才执行请求的操作。如果所需的检查在给定的 内未通过，则操作将失败，并显示TimeoutError。当元素具有非空边界框且没有计算样式时，元素被视为可见。请注意，零大小或 with 的元素不被视为可见。当元素至少连续两个动画帧保持相同的边界框时，该元素被视为稳定。指元素已连接到Document或者ShadowRoot.

如果某些文件路径是相对的，则相对于当前工作目录解析它们。此方法将发出所有必需的键盘事件，可以在按键之间指定可选，以模拟真实的用户行为。对单选框复选框进行勾选，使用is_checked()方法判断选中状态。可以对元素进行单击，双击、右键点击、组件键单击、悬浮、按照坐标单击。此字符区分大小写，因此 和 将产生不同的结果。可以根据value或者label来选择下拉框，也可以进行多选。在输入文本后，可以对元素发出键盘按键事件，如按下Enetr，适用于input、textarea、其他可编辑内容的元素。

browser.new_context() 创建一个新的浏览器上下文。它不会与其他浏览器上下文共享 cookies/缓存。context之间是相互隔离的，可以理解为轻量级的浏览器实例。

playwright支持PO模式。

是playwright自动等待和重试功能的核心部分。简而言之，定位器表示一种随时在页面上查找元素的方法。如下这些是推荐的按显式和隐式辅助功能属性进行定位。使用F12元素拾取工具，可以看到一个元素的name和role。定位器反映用户和辅助技术如何感知页面，例如某些元素是按钮还是复选框。按角色查找时，通常还应传递辅助名称，以便定位器精确定位确切的元素。角色定位器包括按文本内容定位。通过元素包含的文本查找元素。使用时，可以通过子字符串、精确字符串或正则表达式进行匹配。

playwright出自名门,是微软研发团队所开发的一款Web自动化测试框架,发布于2020年初。Playwright 是专门为了满足端到端测试的需求而创建的库。Playwright 支持所有现代渲染引擎，包括 Chromium、WebKit 和 Firefox。在 Windows、Linux 和 macOS 上进行本地或 CI 测试，无头测试或使用本机移动模拟进行测试。