剧作家下载 - 剧作家源码下载

剧作家

其他源码

下载

？剧作家

文档 | API参考

Playwright 是一个用于 Web 测试和自动化的框架。它允许使用单个 API 测试 Chromium、Firefox 和 WebKit。 Playwright 旨在实现常青、强大、可靠且快速的跨浏览器 Web 自动化。

	Linux	macOS	视窗
铬131.0.6778.33	✅	✅	✅
网络工具包 18.0	✅	✅	✅
火狐浏览器132.0	✅	✅	✅

所有平台上的所有浏览器都支持无头执行。查看系统要求以了解详细信息。

正在寻找 Python、.NET 或 Java 的 Playwright？

安装

Playwright 有自己的用于端到端测试的测试运行器，我们称之为 Playwright Test。

使用初始化命令

开始使用 Playwright Test 的最简单方法是运行 init 命令。

 # Run from your project's root directory
npm init playwright@latest
# Or create a new project
npm init playwright@latest new-project

这将创建一个配置文件，可以选择添加示例、GitHub Action 工作流程和第一个测试 example.spec.ts。您现在可以直接跳转到编写断言部分。

手动

添加依赖并安装浏览器。

npm i -D @playwright/test
# install supported browsers
npx playwright install

您可以选择仅安装选定的浏览器，请参阅安装浏览器了解更多详细信息。或者您可以根本不安装浏览器并使用现有的浏览器通道。

入门
API参考

能力

有弹性 • 没有不稳定的测试

自动等待。剧作家在执行操作之前等待元素可操作。它还具有丰富的内省活动。两者的结合消除了人为超时的需要——这是造成不稳定测试的主要原因。

网络优先的断言。剧作家断言是专门为动态网络创建的。检查会自动重试，直到满足必要的条件。

追踪。配置测试重试策略，捕获执行跟踪、视频和屏幕截图以消除碎片。

无需权衡 • 无限制

浏览器在不同的进程中运行属于不同来源的网页内容。 Playwright 与现代浏览器的架构保持一致，并在进程外运行测试。这使得 Playwright 摆脱了典型的进程内测试运行器限制。

多重一切。跨越多个选项卡、多个源和多个用户的测试场景。为不同的用户创建具有不同上下文的场景，并在您的服务器上运行它们，所有这些都在一次测试中完成。

可信事件。悬停元素、与动态控件交互并生成可信事件。 Playwright 使用与真实用户无法区分的真实浏览器输入管道。

测试框架，穿透 Shadow DOM。剧作家选择器穿透 Shadow DOM 并允许无缝输入帧。

完全隔离 • 快速执行

浏览器上下文。 Playwright 为每个测试创建一个浏览器上下文。浏览器上下文相当于一个全新的浏览器配置文件。这提供了零开销的完整测试隔离。创建新的浏览器上下文只需几毫秒。

登录一次。保存上下文的身份验证状态并在所有测试中重用它。这绕过了每个测试中的重复登录操作，但提供了独立测试的完全隔离。

强大的工具

代码生成器。通过记录您的操作来生成测试。将它们保存为任何语言。

剧作家监察员。检查页面、生成选择器、逐步执行测试执行、查看点击点并探索执行日志。

跟踪查看器。捕获所有信息以调查测试失败。 Playwright 跟踪包含测试执行截屏、实时 DOM 快照、动作资源管理器、测试源等等。

正在寻找 TypeScript、JavaScript、Python、.NET 或 Java 的 Playwright？

示例

要了解如何运行这些 Playwright 测试示例，请查看我们的入门文档。

页面截图

此代码片段导航到 Playwright 主页并保存屏幕截图。

 import { test } from '@playwright/test' ;

test ( 'Page Screenshot' , async ( { page } ) => {
  await page . goto ( 'https://playwright.dev/' ) ;
  await page . screenshot ( { path : `example.png` } ) ;
} ) ;

移动和地理定位

此代码片段在给定地理位置的设备上模拟 Mobile Safari，导航到maps.google.com，执行操作并截取屏幕截图。

 import { test , devices } from '@playwright/test' ;

test . use ( {
  ... devices [ 'iPhone 13 Pro' ] ,
  locale : 'en-US' ,
  geolocation : { longitude : 12.492507 , latitude : 41.889938 } ,
  permissions : [ 'geolocation' ] ,
} )

test ( 'Mobile and geolocation' , async ( { page } ) => {
  await page . goto ( 'https://maps.google.com' ) ;
  await page . getByText ( 'Your location' ) . click ( ) ;
  await page . waitForRequest ( / .*preview/pwa / ) ;
  await page . screenshot ( { path : 'colosseum-iphone.png' } ) ;
} ) ;

在浏览器上下文中评估

此代码片段导航到 example.com，并在页面上下文中执行脚本。

 import { test } from '@playwright/test' ;

test ( 'Evaluate in browser context' , async ( { page } ) => {
  await page . goto ( 'https://www.example.com/' ) ;
  const dimensions = await page . evaluate ( ( ) => {
    return {
      width : document . documentElement . clientWidth ,
      height : document . documentElement . clientHeight ,
      deviceScaleFactor : window . devicePixelRatio
    }
  } ) ;
  console . log ( dimensions ) ;
} ) ;

拦截网络请求

此代码片段为页面设置请求路由以记录所有网络请求。

 import { test } from '@playwright/test' ;

test ( 'Intercept network requests' , async ( { page } ) => {
  // Log and continue all network requests
  await page . route ( '**' , route => {
    console . log ( route . request ( ) . url ( ) ) ;
    route . continue ( ) ;
  } ) ;
  await page . goto ( 'http://todomvc.com' ) ;
} ) ;