@applitools/eyes-universal

中文文档

2.18.0发布于 2022/12/27SEE LICENSE IN LICENSECommonJS近 30 天下载 2710

Applitools 双眼通用 SDK

文档目录16 节

导言
网络安全套
运行通用服务器
CLI 参数
通用 SDK 通讯协议
客户发起的活动
客户端启动的命令
服务器启动的命令
光谱驱动器
工具命令
核心命令
参考
参考存储
参考格式
参考使用
API 密码

环球眼

环球眼

导言

A. 客户执行的主要目的客户端)是对JavaScript(JavaScript)中执行的功能核心提供语言绑定服务器) (中文(简体) ). 服务器 控制一切,和 客户端 不需要知道如何工作.

给 客户端 能够与 服务器 它必须执行 WebSocket 客户端通讯层。通过 WebSocket 频道 客户端 可将命令发送到 服务器 同时执行任何行动 服务器 将命令发送给 客户端 以便实现环境自动化. 客户端 必须执行一套命令(光谱驱动器),并在 服务器 会要求它。由于执行任何命令都要求知道上下文,这个命令应该在其中执行, 客户端 应当通过一些上下文提及 服务器解决这一问题 客户端 必须执行参考机制。参考应帮助 客户端 将非序列数据发送到服务器,当从服务器收到此数据时,将很容易将其解回原非序列数据对象.

在使用基于WebDrive的 客户端(a) 执行光谱驱动器可以避免,也可以避免参考执行。这种简化可以通过提供有关WebDriver自动化会话而不是驱动程序的信息来实现,还需要提供元素ID而不是元素. 由于所有非串行式对象被可串行式数据对象所取代,因此需要在参考被删除.

客户实施的最大部分是实际的用户化 API 层,它不应包含任何特定的逻辑,而只执行一些输入数据验证,收集和处理,然后将这些数据发送到服务器. API层不应对它应该使用的自动化框架有任何约束性,它会有助于对不同的框架再使用API层.

网络安全套

通用 sdk 的客户端-服务器架构需要执行介于 客户端 编辑 服务器由于主要需要双向通信,因此选择了WebSocket协议。 WebSocket协议只使用消息操作,每个消息都是独立的数据块. 协议不支持在消息上获得响应. 这就是为什么通信格式是由专有的请求-答复通讯接口决定的(通用 SDK 通讯协议),这需要客户端-服务器消息的特定格式.

所有命令都应作为请求处理,这意味着在收到请求后始终必须发出答复。但简单的事件也是允许的 通用 SDK 通讯协议,这意味着 客户端,以及 服务器,可以发送一个不需要任何响应的信息.

参考执行情况: 联合来文的执行, (中文(简体) ), Ruby 执行

运行通用服务器

客户端想要生成通用服务器并与它通信,应当知道服务器正在听取收到的WebSocket请求的端口. 了解端口的方法是将输出的一行消耗到服务器的 stdout 流线。此行将是用于 ws://localhost:{port}/eyes,例如如果此行是 21077,然后连接到服务器的 URL 是 ws://localhost:21077/eyes。。。 .

当启动服务器时,可能会出现冲突情况——通用服务器可能已经在所期望的端口运行. 当这种情况发生时,通用服务器会尝试一个“手摇”程序,其进程会监听 port。如果有另一个通用服务器编号在港口听,和 singleton 指定(这是默认值,见 CLI 参数然后通用服务器进程将写入 port 然后关闭自己. 对客户来说,这是无缝的 - 客户端没有办法知道它产生的过程是否确实是这个端口的相同过程.

如果握手失败,意味着没有通用服务器,或者它是不同版本的通用服务器,那么行为就被定义为: lazy 参数。默认, lazy 实值 true 这意味着服务器会尝试找到一个免费的端口来收听. 若为 lazy 实值 false,然后服务器进程将以非零代码退出.

CLI 参数

$ ./universal-server-linux --help

Options:
      --help          Show help                                        [boolean]
      --version       Show version number                              [boolean]
  -p, --port          run server on a specific port.   [number] [default: 21077]
  -s, --singleton     runs server on a singleton mode. It will prevent the
                      server to start in case the same server is already
                      started.                         [boolean] [default: true]
  -l, --lazy          runs server on a lazy mode. It will not try to find a free
                      port if the required one is already taken.
                                                      [boolean] [default: false]
      --idle-timeout  time in minutes for server to stay responsible in case of
                      idle.                               [number] [default: 15]
      --config        json string to use instead of cli arguments       [string]
      --eg            launch the execution grid client[boolean] [default: false]

通用 SDK 通讯协议

协议描述了不同类型电文的格式,例如: 请求, (中文(简体) ), 回应,以及活动。每条消息应被格式化为 JSON 字符串.

IDEA 也许支持UBJSON这样的东西也是有道理的,也许有助于发送截图 客户端 而不转换到基数64字符串,这显然是一种间接费用.

两个客户端的服务器都使用自己的非序列对象进行操作,这些非序列对象必须以某种方式通过WebSocket发送. 在客户端上,非串行性对象是驱动器,元素,也可能是选择器,同时服务器以跑道和眼睛抽象操作. 协议描述了通过单独的模块来表示不可序列对象(对于客户端和服务器)的通用方法参考带有严格的批示和参考格式.

请求格式

{
  name: string, // could be any string, but recommended format is "<Domain>.<requestName>" (e.g. "Driver.executeScript")
  key: string, // could be any random string, this value will be used to associate response with actual request.
  payload?: any // any input data
}

答复格式

{
  name: string, // name of the request this response sent for
  key: string, // key value received in request
  payload: {
    result?: any, // result of the request if it was finished successfully
    error?: { // error object if exception was thrown during action processing
      message: string // error massage
      stack: string // error stack trace
    }
  }
}

事件格式

{
  name: string, // could be any string, but recommended format is "<Domain>.<eventName>"
  payload?: any // any event data
}

客户发起的活动

为了把一些数据传递给 服务器 并让 服务器 自行处理 客户端 能够发送轻量级事件( e)事件格式)),不会以任何方式回应.

会议.init

此事件必须在连接到 客户端 财务报告和审定财务报表 服务器 将成立. 客户端 应以一种格式发送关于其自身的重要元数据:

{
  name: string, // name of the client sdk
  version: string, // version of the client sdk
  commands?: string[], // array of command names that could be processed by the client sdk
  protocol?: 'webdriver' // the name of the prebuilt server-side spec driver
}

客户端启动的命令

为了执行任何行动 客户端 需要向您发出适当的请求 服务器 以特定格式(请求格式)并在此描述的格式等待回复(答复格式) (中文(简体) ).

Core. make Manager (管理者)

应当发送此请求以创建管理器对象。它期望输入类型眼睛管理器配置。。。 .

作为回应,客户应期望获得管理人员的参考(管理器参考),该参考文献必须被使用,以便执行与管理人员有关的行动(e眼睛管理者,打开眼睛, (中文(简体) ), 眼睛管理者,关闭管理者(中文(简体) )

当命令被发送时 EyesManager 当实际的视物必须打开时,它会懒散地发送。注意,在这个架构中,眼睛只能从管理者实例中被创造出来,而眼睛的创造和开口被组合在一个单一的操作中.

眼睛管理者,打开眼睛

此命令必须用来创建眼睛对象. 它期望与相关管理器参考 (从) Core. make Manager (管理者), (中文(简体) ), 驱动参考,以及眼睛连接格式为:

{
  manager: ManagerRef, // reference received from "Core.makeManager" command
  driver: DriverRef, // reference to the driver that will be used by the server in order to perform automation
  config?: EyesConfig // configuration object that will be associated with a new eyes object, it could be overridden later
}

作为回应,客户端应期望获得目视参考(双眼参考在与眼睛有关的请求中必须使用这一参考(眼睛检查, (中文(简体) ), 双眼分地, (中文(简体) ), 眼睛。摘录 , (中文(简体) ), 眼睛。摘录图文, (中文(简体) ), 双眼相近, (中文(简体) ), 双眼. . (中文(简体) )

眼睛管理者,关闭管理者

这个命令的用意是用来关闭所有用这个跑者所创造出的眼睛对象,中止未关闭的测试,并返回一个带有结果的总结,以及每个眼睛对象的例外. 它期望输入一个相关的管理器参考 (从) Core. make Manager (管理者) (单位:千美元) throwErr 属性 :

{
  manager: ManagerRef
  throwErr: boolean
}

在响应时,客户端会收到形状的汇总对象测试结果摘要

如果 throwErr 实值 true。以下 JavaScript 片段显示如何处理这种错误 :

catch (err) {

  // if it's some internal error that is not mapped to a known state - throw it to the user
  if (!err.info?.testResult) {
    throw err
  }

  // wrap the testResult in the error with a data class 
  const testResult = new TestResultsData(err.info.testResult, deleteTest)

  // throw the right instance of error based on the reason
  if (err.reason === 'test failed') {
    throw new TestFailedError(err.message, testResult)
  } else if (err.reason === 'test different') {
    throw new DiffsFoundError(err.message, testResult)
  } else if (err.reason === 'test new') {
    throw new NewTestError(err.message, testResult)
  }
}

眼睛检查

此命令用于执行检查/匹配动作。它期望输入相关的双眼参考, (中文(简体) ), 检查设置,以及眼睛连接格式为:

{
  eyes: EyesRef,
  settings?: CheckSettings,
  config?: EyesConfig
}

如果成功,客户将收到答复匹配结果对象.

双眼分地

此命令用于执行定位动作。它期望输入相关的双眼参考, (中文(简体) ), 地点,以及眼睛连接格式为:

{
  eyes: EyesRef,
  settings: LocateSettings,
  config?: EyesConfig
}

如果成功,客户端会收到一个回复,其对象是定位器名称,通过地点,与地区对.

{
  [key: string]: Region
}

眼睛。摘录

此命令必须用于从页面中取出文本区域。它期望输入相关的双眼参考, (中文(简体) ), OCRSearch 安排,以及眼睛连接格式为:

{
  eyes: EyesRef,
  settings: OCRSearchSettings,
  config?: EyesConfig
}

在成功的情况下,客户端会收到一个对象的回复,该对象的规律会传入 OCRSearch 安排,与以下数组相关: 文本区域对.

{
  [key: string]: TextRegion[]
}

眼睛。摘录图文

此命令必须用于从页面中取出文本区域。它期望输入相关的双眼参考数组 OCR 实例安排'的,和眼睛连接格式为:

{
  eyes: EyesRef,
  regions: OCRExtractSettings[],
  config?: EyesConfig
}

在成功的情况下,客户端会收到带有数组字符串的响应.

双眼相近

这个命令必须用来关闭眼睛物体并完成测试. 它不会期望任何输入除了关联双眼参考。。。 .

{
  eyes: EyesRef
}

如果成功,客户将收到答复测试结果对象.

由于测试结果状态, 此命令永远不会丢出错误。这一功能应在客户端实施.

双眼. .

此命令必须用于中止眼睛对象。它不会期望任何输入除了关联双眼参考。。。 .

{
  eyes: EyesRef
}

如果成功,客户将收到答复测试结果对象.

核心. get ViewportSize 软件

此命令必须用于获取给定驱动程序当前的视图端口大小。它期望输入为驱动参考格式为:

{
  driver: DriverRef
}

如果成功,客户将收到答复大小对象.

WD协议没有api来提取浏览器窗口的取景器大小,然而Apium有这个api以及CDP. 所以即使通过服务器获取这些信息没有多大意义, 最好用这种方式让服务器了解这些数据.

核心. set 维尤波特Size

此命令必须用来设定当前给定驱动程序将桌面浏览器窗口自动化的视图大小。如果此命令会被执行到不支持视图调整大小错误的驱动程序上, 将会被丢弃。如果无法将视图大小调整到所需的大小, 也会出错。命令预计输入方式驱动参考财务报告和审定财务报表大小格式为:

{
  driver: DriverRef,
  size: Size
}

Core. close Batches (英语)

此命令必须用其ID关闭批次. 它期望输入类型关闭Batches 设置

Core.delete 测试

这个命令必须用来关闭从眼睛仪表板上删除的测试结果.

服务器启动的命令

服务器 需要向 客户端 以便使用驱动程序 api 实现自动化。将通过特殊接口(a.k.a.)进行. 光谱驱动器)摘要列出任何框架细节。请求哪些 服务器 只能用一组光谱驱动器命令.

自兹光谱驱动器有一些命令相互矛盾, 服务器 应该知道它可以发送到 客户端,该信息应当通过会议.init 活动.

每个光谱驱动器命令将作为请求收到 "Driver.<commandName>",例如调用查找元素命令 服务器 将发送 "Driver.findElement" 请求 客户端。这些论点光谱驱动器命令会以有效载荷发送,作为键与参数名称相同的对象,例如调用查找元素命令 服务器 将发送带有密钥的有效载荷 driver 财务报告和审定财务报表 selector。结果光谱驱动器命令必须由 客户端 作为回应信息中的有效载荷.

光谱驱动器

光谱驱动程序(Spec driver)是一组简单的函数,每个函数通过调用框架(如硒)API来进行自动化. 我们需要我们代码与一个实际驱动器之间的接口来抽象出框架的api.

下面是一份清单,其中描述了可在光谱驱动程序中执行的每一种方法,但执行的必要性取决于框架.

工具命令

`isDriver`

此命令接受驱动程序实例作为参数, 应当返回 true 如果这是有效的驱动实例, 否则 false。。。 .

参考: TS 硒

`isElement`

此命令接受元素为参数并应当返回 true 如果这是一个有效的元素, 否则 false。。。 .

参考: TS 硒, (中文(简体) ), Ruby 硒

`isSelector`

此命令接受选择器为参数并返回 true 如果这是有效的选择器, 否则 false。有效选择者应是三种格式之一:

框架支持的(例如:. By.css('html') (单位:千美元)
JSON 有属性的对象 type 有数值 "css" 或者说 "xpath" 财务报告和审定财务报表 selector 带有字符串值.
简单字符串,如果框架本身不处理字符串,那么该字符串就应当作为cs选择器处理.

参考: TS 硒

`transformDriver`

此命令只用于驱动程序一次,以便在给定驱动程序实例中进行一些修改甚至替换. 如果在开始与驱动程序合作之前需要一些额外的配置,可能有所帮助。如果在每次从它返回时都会使用这种方法,而不是驱动程序.

参考: TS 硒

`transformElement`

此命令用于在使用元素前转换元素( 如 : executeScript 参数)。它接受一个必须作为元素对待的值,但框架本身无法单独处理这个值. 有些框架可能支持不止一种要素格式,这些格式在使用上可能并不相同.

如何理解你应该改变什么格式? 要正确了解哪种格式优于其他格式, 您应该检查哪个格式最有效执行脚本财务报告和审定财务报表子文件夹。。。 .

参考: TS WDIO 软件

`extractSelector`

此命令用于从元素对象中提取选择器。并非所有框架都保留关于用于查找元素的筛选器的信息,但如果它有助于处理一些带有 stale 元素错误的边缘大小写.

参考: TS WDIO 软件

`isStaleElementError`

此命令用于理解一个错误是 stale 元素错误, 它接受一个错误对象并应当返回 true 如果错误是由于元素引用被 stale.

参考: TS 硒

`isEqualElements`

如果两个元素对象在网页上(或在本地应用程序中)引用同一元素,则使用此命令来理解是否返回 true 如果元素是一样的.

WD! 可以用其识别码来比较要素,因为根据协议规格,识别码在所有框架都应是独一无二的,同一要素也应是相同的,但并非所有WD执行都保持这一规则(例如iOS Safari)。在这种情况下,可以通过执行一个脚本与那些可以比较的元素来将元素在浏览器中进行比较,如果抛出一个陈旧元素出错,则元素显然并不等同.

参考: TS WDIO 软件

核心命令

本节中的每个命令都接受驱动程序/文本作为第一个参数.

`mainContext`

此命令用于从当前/赋予的框架获取主/上级框架的访问.

WD! 此命令必须将驱动程序当前框架更改为最上方框架,而不一定返回驱动程序.

CDP! 这个命令必须从给定的框架中返回最上层(没有父的)框架.

参考文献: TS 硒, (中文(简体) ), TS 剧作家, (中文(简体) ), Ruby 硒

`parentContext`

此命令用于访问当前/给定的框架的父框架 .

WD! 此命令必须将驱动程序当前框架更改为当前框架的父框架,而不一定返回驱动程序. 一些框架(如硒3,wdio 4)的后遗症实施没有这个功能的专用api,在此情况下,执行动作的唯一途径是自己向终点发送请求(英语:Selenium 3, wdio 4)WD 光谱) (中文(简体) ).

CDP! 此命令必须返回给定框架的父框架( 上一个等级) .

参考文献: TS 硒, (中文(简体) ), TS 剧作家, (中文(简体) ), Ruby 硒

`childContext`

此命令用于访问当前/ 给定框架的子框架元素指目标iframe.

WD! 此命令必须使用给定的元素将驱动程序当前框架更改为子框架,而不一定要返回驱动程序 .

CDP! 这个命令必须返回给定元素的内容框架,在参数中仍然提供父框架,但协议不需要使用.

参考文献: TS 硒, (中文(简体) ), TS 剧作家, (中文(简体) ), Ruby 硒

`executeScript`

此命令在特定上下文中执行特定类型字符串的脚本.

CDP! 协议无法执行不是函数声明的脚本,这意味着仅仅是函数正文或JS表达式不是有效的脚本,例如: return document. title,必须转换为 function(){ return document.title }。。。 .

参考文献: TS 硒, (中文(简体) ), TS 剧作家, (中文(简体) ), Ruby 硒

`findElement`

此命令在特定上下文中由给定选择器查找元素。如果一个元素不存在, null 应返回( e)不丢) (中文(简体) ). 见选择器命令用于选择格式.

参考: TS 硒, (中文(简体) ), Ruby 硒

`findElements`

此命令在特定上下文中通过给定选择器查找多个元素。如果没有元素存在,则需要一个空阵列([]应还. 见选择器命令用于选择格式.

参考: TS 硒, (中文(简体) ), Ruby 硒

`getDriverInfo`

此命令用于从一开始提取驱动程序和环境的信息. 记住,并非所有财产都是必要的.

这是JSON对象的一个计划这种方法应该返回.

{
  sessionId?: string, // aut session id
  isMobile?: boolean, // true if the environment is a mobile device (e.g. os is android or ios), this doesn't necessarily mean a native app is tested
  isNative?: boolean, // true if the environment is a native app (so no browser)
  deviceName?: string, // device name
  platformName?: string, // os name
  platformVersion?: string, // os version
  browserName?: string, // browser name
  browserVersion?: string, //browser version
}

事实上,如果你的框架不支持本地应用程序自动化,整个方法可以跳过,在这种情况下,数据将从用户代理中提取,但如果可能,更好执行. 所有信息都包含在驱动程序的能力中. 今后,我们不妨在此提供更多的信息.

参考: TS 硒

`getOrientation`

如果框架不支持本地应用程序自动化,则不需要此命令. 此命令应返回 "landscape" 或者说 "portrait" 字符串在小写取决于设备方向.

如果框架支持设备在运行时的旋转,那么方向也应该在运行时取出,而不是从能力取出(App光谱(中文(简体) )

参考: TS WDIO 软件

`getTitle`

此命令应当返回页面的标题 .

参考: TS 硒, (中文(简体) ), Ruby 硒

`getUrl`

此命令应当返回当前页面的url .

参考: TS 硒, (中文(简体) ), Ruby 硒

`takeScreenshot`

此命令应当使用默认框架 api 来取取视图端口的截图(没有任何稳定) (中文(简体) ). 结果应该作为 Base64 编码字符串返回.

参考: TS 硒, (中文(简体) ), Ruby 硒

`getElementRect`

此命令用于获取 本地语言 仅限元素。此命令将不用于网络, 因为需要一个更复杂的算法。将结果作为带有属性的 JSON 对象返回 x, (中文(简体) ), y, (中文(简体) ), width 财务报告和审定财务报表 height,数值应保持分数,不需要四舍五入.

参考: TS 硒

`setWindowSize`

此命令应该从带有属性的给定 JSON 对象设置窗口大小 width 财务报告和审定财务报表 height。命令还必须将窗口位置设置到 (0,0) ,以便归档要设置的最大可能的窗口大小. 如果设置已经执行.

WD! 硒的后遗症实施不允许采用单一方法设定大小和位置,在这种情况下,应当单独设置.

CDP! 协议不支持窗口操纵,而是降低视门操纵,看看设置。。。 .

参考: TS 硒, (中文(简体) ), Ruby 硒

`getWindowSize`

此命令应当以 JSON 对象的格式返回窗口大小, 并带有属性 width,以及 height。。。 . 命令有过将执行,如果窗口大小已执行,如果设置已执行.

WD! 现代对硒的应用没有得到窗口大小的api,而是可以使用得到窗口矩形的api.

APPIUM! Appium服务器的后传版本无法很好地处理获得窗口矩形的命令,在这种情况下,应当发送获得窗口大小的命令.

CDP! 协议不支持窗口操纵,而是降低视门操纵,看看获取 Viewport 大小。。。 .

参考: TS 硒, (中文(简体) ), Ruby 硒

`setViewportSize`

此命令应当设定带有属性的给定 JSON 对象的视图大小 width 财务报告和审定财务报表 height。。。 .

WD! 协议不允许直接操纵取景口. 执行窗口大小财务报告和审定财务报表获取窗口大小换句话说.

参考: TS 剧作家

`getViewportSize`

此命令应返回带有属性的 JSON 对象格式的视图端口大小 width 财务报告和审定财务报表 height。此命令不一定需要执行,因为视图大小可以从浏览器中提取,但如果执行它可能更好,因为框架可能已经掌握了这些信息.

WD! 协议不允许直接操纵取景口. 执行窗口大小财务报告和审定财务报表获取窗口大小换句话说.

参考: TS 剧作家

参考

Sdk必须与之操作的最重要对象是非串行性(如驱动器对象,眼睛即时),无法通过WebSocket协议发送. 它要求采用通用方法来表示非连续物体。下面将描述一种必须用来在客户端和服务器端创建引用的方法.

参考执行情况: 联合来文的执行, (中文(简体) ), Ruby 执行

参考存储

参考文件应当有一个按键值存储,每个对象的参考文件都标出。存储中的密钥是参考对象中使用的guid. 物品一旦不再使用,就应该从储存处取出。存储应该支持不同引用之间的关系,意味着某些引用的存在应该取决于其他引用的存在(例如,当驱动程序已经被破坏时将元素保存在存储中是没有意义的).

参考格式

每个裁判都是JSON对象,只有一个财产 applitools-ref-id 带有 guid 字符串值.

{
  'applitools-ref-id': string
}

在某些情况下,如何可以扩展参考接口,以提供更多的关于它所提到的对象的数据,例如,在元素引用中添加关于选择者的信息是有道理的,在某些罕见的情况下,这样可以避免与服务器的前后通信.

参考使用

从服务器引用( 从命令) 收到的客户端 Core. make Manager (管理者) 财务报告和审定财务报表眼睛管理者,打开眼睛)只能用于执行与这些参考对象有关的其他服务器侧动作. 然而,客户端向服务器发送的引用将不可避免地在其中之一收到服务器启动的命令,在这种情况下,客户端应当参照收到的参考文献,参考需要的操作与实际对象.

API 密码

API层是客户端执行中最大的部分,它应该抽象出最终用户从内部执行中使用 sdk的方式. 该层的主要功能目的应该是收集用户的所有配置和输入,并在应实际采取行动时发送. 这种架构的最大好处是API(sdk中最大和最混乱的部分)不应该为每个新框架反复被重新执行.

参考执行情况: TS 眼睛动画

版本与发布记录

@applitools/eyes-universal 共发布 137 个版本，首次发布于 2021/06/01；过去 12 个月发布了 0 个版本。

版本	发布日期	距今
`2.18.0`latest	2022/12/27	3 年前
`2.17.4`	2022/12/22	3 年前
`2.17.3`	2022/11/29	3 年前
`2.17.2`	2022/11/17	3 年前
`2.17.1`	2022/11/16	3 年前
`2.17.0`	2022/11/02	4 年前

其他发布通道：beta → 2.0.0-beta.1。

关于 @applitools/eyes-universal 的常见问题

@applitools/eyes-universal 是什么？

Applitools 双眼通用 SDK

如何安装 @applitools/eyes-universal？

在项目目录运行 npm install @applitools/eyes-universal，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 eyes-universal，可以用 npx eyes-universal 直接运行。

@applitools/eyes-universal 支持 TypeScript 吗？

该包的 package.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/applitools__eyes-universal 是否存在。

@applitools/eyes-universal 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require()；在 ES Module 项目中也可以用 import 引入（Node.js 会把 module.exports 作为默认导出）。

@applitools/eyes-universal 需要什么版本的 Node.js？

package.json 的 engines 字段要求 Node.js >=12.13.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

@applitools/eyes-universal 可以商用吗？

@applitools/eyes-universal 使用 SEE LICENSE IN LICENSE 许可。许可条款写在包内的独立文件中，请阅读该文件确认可否商用。以上为概括，不构成法律意见，请以许可原文为准。

@applitools/eyes-universal 的下载量有多少？

根据 npm 官方下载统计，@applitools/eyes-universal 在 2026/10/07 – 2026/11/05 这 30 天内被下载 2,710 次，日均约 90 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

@applitools/eyes-universal 还在维护吗？

最新版本 2.18.0 发布于 2022/12/27（3 年前）；至今共发布 137 个版本，其中过去 12 个月发布了 0 个；首次发布于 2021/06/01。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。

npm install @applitools/eyes-universal

pnpmpnpm add @applitools/eyes-universal
yarnyarn add @applitools/eyes-universal
bunbun add @applitools/eyes-universal

命令行npx eyes-universal

在你的项目目录中运行此命令。

近 30 天下载

2,710

约 2710 次日均 90 次

统计周期 2026/10/07 – 2026/11/05
数据来自 npm 官方下载统计，1 天前更新

最新版本2.18.0发布于 3 年前

开源许可SEE LICENSE IN LICENSE自定义许可

包体积147 kB21 个文件 · 解压后

运行依赖10 个

模块格式CommonJS

TypeScript未声明类型可查找 @types/applitools__eyes-universal

Node.js>=12.13.0

发布版本137 个近 12 个月 0 个

首次发布2021/06/015 年前

元数据更新2026/06/28

每一个软件包背后，
都有分享与创造的人。

@applitools/eyes-universal

环球眼

导言

网络安全套

运行通用服务器

CLI 参数

通用 SDK 通讯协议

请求格式

答复格式

事件格式

客户发起的活动

会议.init

客户端启动的命令

Core. make Manager (管理者)

眼睛管理者,打开眼睛

眼睛管理者,关闭管理者

眼睛 检查

双眼 分地

眼睛。 摘录

眼睛。 摘录图文

双眼相近

双眼. .

核心. get ViewportSize 软件

核心. set 维尤波特Size

Core. close Batches (英语)

Core.delete 测试

服务器启动的命令

光谱驱动器

工具命令

isDriver

isElement

isSelector

transformDriver

transformElement

extractSelector

isStaleElementError

isEqualElements

核心命令

mainContext

parentContext

childContext

executeScript

findElement

findElements

getDriverInfo

getOrientation

getTitle

getUrl

takeScreenshot

getElementRect

setWindowSize

getWindowSize

setViewportSize

getViewportSize

参考

参考存储

参考格式

参考使用

API 密码

版本与发布记录

关于 @applitools/eyes-universal 的常见问题

@applitools/eyes-universal 是什么？

如何安装 @applitools/eyes-universal？

@applitools/eyes-universal 支持 TypeScript 吗？

@applitools/eyes-universal 支持 ESM 还是 CommonJS？

@applitools/eyes-universal 需要什么版本的 Node.js？

@applitools/eyes-universal 可以商用吗？

@applitools/eyes-universal 的下载量有多少？

@applitools/eyes-universal 还在维护吗？

眼睛检查

双眼分地

眼睛。摘录

眼睛。摘录图文

`isDriver`

`isElement`

`isSelector`

`transformDriver`

`transformElement`

`extractSelector`

`isStaleElementError`

`isEqualElements`

`mainContext`

`parentContext`

`childContext`

`executeScript`

`findElement`

`findElements`

`getDriverInfo`

`getOrientation`

`getTitle`

`getUrl`

`takeScreenshot`

`getElementRect`

`setWindowSize`

`getWindowSize`

`setViewportSize`

`getViewportSize`