设置指南: 各项设置的作用
在 Studio 中打开设置, 每个选项的名称下方都有相应说明。本页面汇总了这些说明, 方便你提前阅读、搜索, 或请 AI 助手逐项讲解。
最后更新:
设置的使用方式
- 先更改, 再保存。按需编辑后, 点击保存更改。设置旁边的圆点表示该设置已更改但尚未保存。
- 大多数人只需更改少量设置。每项设置都有合理的默认值。如果不确定, 保持原样即可。
- 敏感信息只保存在你的电脑上。密码、令牌和密钥保存在工作区的
.env文件中, 并以圆点显示。任何内容都不会发送给我们。 - 灰色名称是设置在文件中的名称。它对应
.env中的配置项, 方便你通过流水线或脚本进行设置。
安全 & 身份验证
API 测试登录.
| 设置 | 功能 | 默认 |
|---|---|---|
API 令牌或密码API_AUTH_TOKEN | API 用于验证的密钥,可从 API 提供商的账号页面获取;使用 Basic 认证时,请输入 user:password。留空表示不登录;报告中仅显示其前 4 个字符。 | 空。仅保存在此电脑上。 |
API 登录方式API_AUTH_TYPE | API 验证调用者身份的方式: Bearer 发送令牌, Basic 发送用户名和密码, ApiKey 在请求头中发送密钥. 默认值为 Bearer. | Bearer |
API 密钥请求头名称API_AUTH_HEADER | 仅适用于 ApiKey: 用于携带密钥的请求头名称, 例如 api-key. 留空则使用 X-Api-Key. | Empty |
Smart Monkey
探索时执行额外 API 安全检查.
| 设置 | 功能 | 默认 |
|---|---|---|
被动式 API 安全检查NEXUS_API_AUDIT | 探索期间, 读取应用已收到的 API 响应, 标出数据泄露等薄弱环节, 不发送任何额外请求. 默认关闭; 仅可用于您获准测试的应用. | false |
登录绕过检查NEXUS_API_ACTIVE | 将应用原本携带登录令牌发送的数据请求去掉令牌后再次发送,以检查服务器是否仍会响应。仅执行只读操作,但会发送额外请求; 默认关闭。 | false |
目标 & API
API 地址, 速率限制和保存的证据.
| 设置 | 功能 | 默认 |
|---|---|---|
API 主地址API_BASE_URL | 仅包含路径(如 /users)的 API 测试所使用的起始地址,例如 https://api.example.com。请留空:此处设置地址也会将所有录制的 API 测试重定向到该地址。 | Empty |
GraphQL 地址API_GRAPHQL_URL | GraphQL 服务的地址(这类 API 可让你精确指定所需数据)。如果留空,内置 GraphQL 示例将查询公共演示服务,而不是你的服务。 | Empty |
允许的最长响应时间NEXUS_API_LATENCY_BUDGET | API 响应的最长允许时间, 单位为毫秒 (1000 = 1 秒); 超时响应会被标记为缓慢. 默认值为 2000 (2 秒). | 2000 |
每个请求的计时重复次数NEXUS_API_SAMPLES | 为可靠测量速度而重复发送每个 API 请求的次数 (1 至 200); 仅检查第一次响应. 默认值为 20; 如果重复请求会影响服务器, 请调低此值. | 20 |
重复发送更改数据的请求NEXUS_API_SAMPLE_WRITES | 同时重复执行创建或更改数据的请求 (POST, PUT, PATCH, DELETE). 默认关闭, 因为重复 20 次会在服务器上创建 20 条记录. | false |
响应发生变化时判定失败NEXUS_API_DRIFT_STRICT | 响应中新增字段或更改数据类型时, 始终会报告为发生偏移. 开启后还会将测试判为失败; 关闭时 (默认) 仅报告. | false |
保留的成功 API 测试运行数NEXUS_API_EVIDENCE_KEEP | 每项 API 测试保留已保存证据的通过运行次数; 较旧的证据将被删除, 失败运行的证据则始终保留. 默认值为 20; 0 表示保留所有运行的证据. | 20 |
保存的响应大小上限NEXUS_API_BODY_MAX_KB | 证据文件中保存的请求体或响应体的最大大小, 单位为 KB; 超出部分会被截断, 并记录其完整大小和指纹. 默认为 256 KB. | 256 |
响应缓慢时判定失败NEXUS_API_PERF_STRICT | 启用后, 如果响应时间超过上方允许的时长, API 测试将判为失败. 关闭时 (默认): 响应缓慢只会添加警告. | false |
检查 API 安全响应头NEXUS_API_SECURITY_HEADERS | 检查 API 响应是否包含标准安全响应头 (例如 Content-Security-Policy); 缺少响应头时仅提供建议, 不会单独导致测试失败. 默认开启. | true |
被测应用
运行前自动启动应用.
| 设置 | 功能 | 默认 |
|---|---|---|
启动应用的命令NEXUS_APP_START | 每次运行前启动应用, 运行后停止应用, 例如 npm run dev; 留空 = 自行启动. 仅允许一条命令: 请将含 && 等连接符的命令放入 package.json 脚本中. | Empty |
应用文件夹NEXUS_APP_CWD | 应用启动目录的完整路径, 即 package.json 所在的文件夹; 留空则使用此工作区文件夹. 在远程计算机上, 此路径指向该计算机上的文件夹. | Empty |
表示已就绪的地址NEXUS_APP_READY_URL | 每半秒检查一次的网址,用于确认应用是否已启动;除服务器错误外,任何响应均视为已启动。留空则使用主测试地址 (BASE_URL)。 | Empty |
启动等待时间上限NEXUS_APP_TIMEOUT_MS | 等待应用就绪的时间, 单位为毫秒 (1000 = 1 秒); 超过此时间则不会开始运行. 默认值为 120000 (2 分钟). | 120000 |
复用正在运行的应用NEXUS_APP_REUSE | 开启: 如果应用已在就绪地址响应, 则使用该应用并保持其运行; 关闭: 本次运行会报错停止, 避免误测其他应用. 默认开启. | true |
执行 & 超时
测试运行数量和等待时间.
| 设置 | 功能 | 默认 |
|---|---|---|
每项测试使用的浏览器数NEXUS_PARALLEL_BROWSERS | 同时运行同一测试的浏览器数, 范围为 1 至 3; 默认值 1 最稳妥, 2 约需 8 GB 内存, 3 约需 16 GB. 指定单个浏览器的运行始终仅使用一个浏览器. | 1 |
同时运行的测试数NEXUS_PARALLEL_TCS | 完整运行中并行执行的测试数, 范围为 1 至 32; 默认值为 1 (逐个执行). 每增加一项测试, 每个浏览器约需额外 0.5 GB 内存, 因此仅建议在性能较强的电脑上调高此值. | 1 |
重试失败的测试NEXUS_RETRY_ENABLED | 测试失败后会再运行一次, 然后才报告结果, 以排除偶发故障. 关闭后可立即查看每次失败; 默认开启. | true |
每项测试的时间限制NEXUS_TC_TIMEOUT | 单次测试在被强制停止前可运行的最长时间, 单位为秒. 默认值为 360 (6 分钟); 测试本身会提前 1 分钟停止, 以便保存证据. | 360 |
检查等待时间NEXUS_EXPECT_TIMEOUT | 检查条件 (如 "此文本出现") 成立前的等待时间, 单位为毫秒 (1000 = 1 秒); 调高此值有助于适应较慢的页面, 且不会掩盖缺陷. 默认值为 10000 (10 秒). | 10000 |
每次点击或输入的等待时间NEXUS_ACTION_TIMEOUT | 点击或输入等步骤等待目标就绪的时间, 单位为毫秒 (1000 = 1 秒). 页面较慢时可调高此值; 默认值为 30000 (30 秒). | 30000 |
页面打开时限NEXUS_NAV_TIMEOUT | 打开页面的最长等待时间, 超时则该步骤失败, 单位为毫秒 (1000 = 1 秒). 默认值为 60000 (1 分钟); 网站非常慢时可调高此值. | 60000 |
页面打开后的等待时间NEXUS_LOAD_WAIT_MS | 页面打开后, 最多等待指定的毫秒数 (1000 = 1 秒), 让页面完成加载, 避免过早点击. 此等待不会导致测试失败; 设为 0 则跳过, 默认为 8000. | 8000 |
缺少安全响应头时判定失败NEXUS_SECURITY_STRICT | 启用后, 如果应用页面缺少防护标头 (如 Content-Security-Policy), 测试将判为失败. 关闭时 (默认) 仅在报告中记录; 对于较旧的应用, 启用后可能导致所有测试失败. | false |
Firefox 位置NEXUS_FIREFOX_BINARY | firefox.exe 的完整路径, 仅供 Selenium 测试使用; 留空 = 在常见位置查找. 路径错误将视为未安装 Firefox, 因此会跳过相应的 Selenium 测试. | Empty |
故意失败的测试NEXUS_FIXTURE_TCS | 故意编写为失败的测试的 ID, 以逗号分隔. 除非你明确要求纳入, 否则这些测试不会出现在风险排名中; 默认为空. | Empty |
选择器 & 自修复
不稳定选择器检测与修复.
| 设置 | 功能 | 默认 |
|---|---|---|
不稳定步骤警告NEXUS_SMART_SELECTORS | 录制或导入测试时, 选择建议会在每个使用不稳定定位方式的步骤上方添加注释; 选择关闭则不添加. 已编写的测试不会更改; 默认为建议. | suggest |
自动修复建议NEXUS_SELF_HEAL | 失败后,在后台浏览器中准备修复方案(内存不足或正在运行时跳过)。“建议”会显示修复方案,“验证”还会在 3 个浏览器中测试这些方案,“关闭”则不执行任何操作。 | suggest |
机器学习运维 & 预测
预测哪些测试不可靠.
| 设置 | 功能 | 默认 |
|---|---|---|
更新不可靠测试预测NEXUS_AUTO_PREDICT | 每次运行后, 更新对不稳定测试 (有时通过, 有时失败) 的预测, 使风险排名保持最新. 默认开启. | true |
无障碍
通过 axe-core 进行 WCAG 审核.
| 设置 | 功能 | 默认 |
|---|---|---|
检查无障碍性NEXUS_A11Y_ENABLED | 扫描页面中影响残障人士使用的障碍,例如对比度过低或缺少标签。默认关闭; 需要 @axe-core/playwright 扩展,未安装时将跳过扫描。 | false |
无障碍规则集NEXUS_A11Y_STANDARD | 选择扫描使用的无障碍规范 (WCAG): 2.0、2.1 或 2.2 版本,以及 A 级 (基础) 或 AA 级 (标准)。默认的 2.1 AA 通常是欧洲的法律最低要求。 | wcag21aa |
最低问题严重程度NEXUS_A11Y_FAIL_LEVEL | 问题达到何种严重程度 (轻微, 中等, 严重, 致命) 才算违规. 默认值为严重; 仅在开启 '发现违规时使测试失败' 时生效. | serious |
违规时判定测试失败NEXUS_A11Y_STRICT | 启用后, 如果测试发现的问题达到或超过最低严重程度, 测试将标记为失败 (A11Y_VIOLATION). 默认关闭: 问题仅列在报告中. | false |
Performance
核心网页指标预算.
| 设置 | 功能 | 默认 |
|---|---|---|
测量页面速度NEXUS_PERF_ENABLED | 测量各页面的加载和响应速度 (核心网页指标), 并与下方限值比较. 默认开启; 仅添加数据, 除非开启 '页面缓慢时判定失败', 否则不会导致测试失败. | true |
主要内容加载时限NEXUS_PERF_LCP | 页面主要内容显示的最长允许时间, 单位为毫秒 (1000 = 1 秒). 默认值为 2500 (2.5 秒), 即 Google 的 '良好' 标准; 对于较慢的网站可调高此值. | 2500 |
首次内容加载时限NEXUS_PERF_FCP | 页面显示首个文本或图像前的最长允许时间, 单位为毫秒 (1000 = 1 秒). 默认值为 1800 (1.8 秒), 即 Google 的 '良好' 标准; 对于较慢的网站可调高此值. | 1800 |
页面布局偏移上限NEXUS_PERF_CLS | 页面加载时允许的布局偏移分数, 0 表示完全稳定. 默认值为 0.1, 即 Google 的 '良好' 标准; 数值越低越严格. | 0.1 |
页面元素数量上限NEXUS_PERF_DOM | 页面允许包含的最多元素数量 (按钮, 文本块, 图像); 超出后会被标记为对低性能设备负担过重. 默认值为 1500. | 1500 |
页面内存上限NEXUS_PERF_HEAP | 页面脚本允许使用的最大内存量, 单位为 MB; 超出后页面会被标记. 默认值为 50 MB; 仅在 Chrome 和 Edge 等基于 Chromium 的浏览器中测量. | 50 |
点击响应时限NEXUS_PERF_INP | 点击或轻触后页面做出反应的最长允许时间, 单位为毫秒 (1000 = 1 秒). 默认值为 200, 即 Google 的 '良好' 标准; 对于较慢的网站可调高此值. | 200 |
页面卡顿时限NEXUS_PERF_TBT | 页面加载期间允许卡住且不响应点击的最长时间, 单位为毫秒 (1000 = 1 秒). 默认值为 200, 即 Lighthouse (Google 的审核工具) 的 '良好' 标准. | 200 |
服务器响应上限NEXUS_PERF_TTFB | 服务器开始发送页面前的最长允许时间, 单位为毫秒 (1000 = 1 秒). 默认值为 800; 结果缓慢通常意味着问题在服务器, 而非页面设计. | 800 |
速度下降容忍度NEXUS_PERF_TOLERANCE | 页面相较于自身历史结果的允许减速倍数, 超过此值时 Evidence Locker 会标记性能回退. 默认值 1.25 表示慢 25%; 值为 1 或更小时将回退为 1.25. | 1.25 |
页面加载缓慢时判定失败NEXUS_PERF_STRICT | 启用后, 如果页面超出上方任一速度限制, 测试将标记为失败 (PERFORMANCE_DEGRADED). 默认关闭: 加载缓慢的页面仅记录在报告中. | false |
检查图片加载NEXUS_LAZY_ENABLED | 检查图片的加载方式是否能保证页面速度, 例如主图是否及时加载. 默认开启, 需启用速度测量, 并提供 0 到 100 的评分, 不会导致测试失败. | true |
首次加载图片时限NEXUS_LAZY_MAX_INITIAL_IMG_KB | 页面首次打开时允许下载的最大图像数据量, 单位为 KB (1000 KB 约为 1 MB); 超出后会被检查标记. 默认值为 1000 KB. | 1000 |
图片出现问题时判定失败NEXUS_LAZY_STRICT | 启用后, 如果主图被刻意延迟加载或首次加载的图片超出上方限制, 测试将标记为失败 (PERFORMANCE_DEGRADED). 默认关闭: 仅报告结果. | false |
负载测试
流量压力测试限制.
| 设置 | 功能 | 默认 |
|---|---|---|
响应时间上限NEXUS_LOAD_P95 | 负载测试运行中, 95% 的请求必须在此毫秒数内完成 (1000 = 1 秒). 留空表示不设限制, 结果将显示 '未评估'; 场景自身的限制优先生效. | Empty |
允许的错误百分比NEXUS_LOAD_ERROR_RATE | 一次负载测试允许的最高请求失败率, 以 0 到 100 的百分比表示 (5 表示每 100 个请求最多可有 5 个失败). 留空表示无限制; 场景自身的限值优先于此设置. | Empty |
未达到限值要求时判定本次运行失败NEXUS_LOAD_STRICT | 启用后, 如果负载测试运行超出响应时间或错误数量限制, 该次运行将以失败结束, 从而中止自动构建. 默认关闭: 仅报告结果. | false |
负载工作进程数NEXUS_LOAD_POOL | 负载测试运行中生成流量的后台工作进程数. 留空时每个处理器核心使用一个进程, 但不超过模拟用户数; 在 Windows 上每个进程约占用 80 MB 内存. | Empty |
硬件 & 节奏控制
在低内存计算机上降低测试速度.
| 设置 | 功能 | 默认 |
|---|---|---|
根据可用内存调节测试节奏NEXUS_HW_MONITOR_ENABLED | 启用后, 可用内存不足时, 应用会延长测试之间的等待时间, 并减少同时运行的测试数量. 默认关闭 (使用固定等待时间); 配置较低或负载较高的电脑建议启用. | false |
测试之间的等待时间NEXUS_HW_FIXED_PAUSE_MS | 关闭内存自适应调节时, 多测试运行中各测试之间的等待时间, 单位为毫秒 (1000 = 1 秒). 默认为 2000 (2 秒); 单测试运行不等待. | 2000 |
微型电脑内存限制NEXUS_HW_CRITICAL_GB | 总内存低于此值 (单位为 GB) 的计算机归为极小内存类型, 测试之间的等待时间最长. 默认值为 4; 仅在启用按内存调整测试间隔时使用. | 4 |
低配置电脑内存上限NEXUS_HW_LIMITED_GB | 总内存低于此值 (单位为 GB) 的计算机归为小内存类型. 默认值为 8; 仅在启用按内存调整测试间隔时使用, 且必须高于极小内存阈值. | 8 |
标准配置电脑内存上限NEXUS_HW_NORMAL_GB | 总内存低于此值 (单位为 GB) 的计算机归为标准类型; 高于此值则归为高性能类型, 等待时间最短. 默认值为 16; 仅在启用按内存调整测试间隔时使用. | 16 |
内存充足时的等待时间NEXUS_PAUSE_LOW_MS | 大部分内存空闲时各测试之间的等待时间, 单位为毫秒 (1000 = 1 秒). 0 (默认) 表示根据电脑配置使用内置的 1 至 3 秒等待时间, 而非不等待; 仅在启用内存自适应调节时生效. | 0 |
内存使用适中时的等待时间NEXUS_PAUSE_MEDIUM_MS | 内存使用适中时各测试之间的等待时间, 单位为毫秒 (1000 = 1 秒). 0 (默认) 表示根据电脑配置使用内置的 2 至 8 秒等待时间, 而非不等待; 仅在启用内存自适应调节时生效. | 0 |
内存不足时的等待时间NEXUS_PAUSE_HIGH_MS | 可用内存不足时各测试之间的等待时间, 单位为毫秒 (1000 = 1 秒). 0 (默认) 表示根据电脑配置使用内置的 4 至 15 秒等待时间, 而非不等待; 仅在启用内存自适应调节时生效. | 0 |
内存满载时的等待时间NEXUS_PAUSE_CRITICAL_MS | 内存接近满载时各测试之间的等待时间, 单位为毫秒 (1000 = 1 秒). 0 (默认) 表示根据电脑配置使用内置的 8 至 25 秒等待时间, 而非不等待; 仅在启用内存自适应调节时生效. | 0 |
Devices & Mobile
用于测试和模拟的手机.
| 设置 | 功能 | 默认 |
|---|---|---|
手机连接端口NEXUS_DEVICE_CDP_PORT | 计算机与已连接 Android 手机上的 Chrome 通信时使用的网络端口号。仅当默认端口 9333 已被其他程序占用时才需更改。 | 9333 |
手机浏览器应用 IDNEXUS_DEVICE_CHROME_PKG | 在已连接的 Android 手机上进行测试时使用的浏览器应用 ID。仅当手机使用其他浏览器时才需更改;默认使用普通版 Chrome (com.android.chrome)。 | com.android.chrome |
通过电脑控制手机NEXUS_MIRROR_CONTROL | 允许您通过电脑上的手机镜像窗口操作手机, 进行点击和输入. 关闭后窗口仅供查看, 不会响应点击; 默认开启. | true |
要模拟的高端手机NEXUS_TIER_HIGH_DEVICE | 高端测试运行中模拟的手机型号:包括屏幕尺寸、浏览器标识和触控。这是在 Safari 引擎中进行的模拟,并非使用实体 iPhone;默认型号为 iPhone 13。 | iPhone 13 |
要模拟的中端手机NEXUS_TIER_MID_DEVICE | 标准移动设备运行中模拟的手机型号,包括屏幕尺寸、浏览器标识和触控。请选择 Android 手机;默认为 Pixel 5。 | Pixel 5 |
要模拟的低端手机NEXUS_TIER_LOW_DEVICE | 低端设备运行中模拟的手机型号,此类运行还会降低处理器速度。请选择 Android 手机;如果留空,则使用内置的入门级手机 (Nokia 1)。 | Empty |
低端设备降速倍数NEXUS_CPU_THROTTLE_RATE | 低端手机测试中处理器的减速倍数, 用于模拟性能较弱的手机. 可设为 2 至 20 (越高越慢); 默认值为 4, 仅适用于基于 Chrome 的浏览器. | 4 |
慢速网络NEXUS_NETWORK_PROFILE | 在较慢的连接下运行每项测试, 查看网站在移动信号较弱时的表现: off (默认), fast-4g, slow-4g, slow-3g 或 offline. 仅支持基于 Chrome 的浏览器和 Android 真机. | 关闭 |
证据 & 保留
保存哪些证据以及保存多久.
| 设置 | 功能 | 默认 |
|---|---|---|
录制失败视频NEXUS_VIDEO_ENABLED | 为每项测试录制视频,以便在测试失败时保留。关闭可节省计算资源和磁盘空间,但所有失败测试都将没有视频; 默认开启。 | true |
保留视频的失败项NEXUS_VIDEO_VERDICTS | 选择要为哪些结果保留视频: 失败、重试后失败、混沌测试下失败、超时或受阻。留空或选择无则不保留任何视频; 默认保留前三种结果的视频。 | BREACHED,BREACHED_FLAKY,CHAOS_BREACHED |
录制逐步回放NEXUS_TRACE_ENABLED | 记录每项测试的所有操作和页面状态,并将回放与失败测试的缺陷报告一同保存。在低配置计算机上可关闭以节省计算资源; 默认开启。 | true |
每项测试保留的缺陷报告数NEXUS_BUGREPORT_RETAIN | 为每项测试的每个浏览器保留的失败报告数. 较旧的报告将被永久删除, 如需保留更长时间的记录, 请调高此值; 默认值为 20. | 20 |
保留的通过测试截图数NEXUS_PASSED_RETAIN | 为每项测试的每个浏览器保留的通过运行截图数. 较旧的截图将被永久删除; 默认值为 5. | 5 |
保留的 Smart Monkey 会话数NEXUS_MONKEY_RETAIN | 保留的 Smart Monkey 会话数 (在应用中随机点击和输入). 较旧的会话将被永久删除; 默认值为 10. | 10 |
保留的运行记录数NEXUS_RUN_CONTEXT_RETAIN | 保留测试对象记录及应用日志的运行次数. 较旧的记录将被永久删除; 默认值为 100. | 100 |
保留重试后通过的证据NEXUS_RECOVERED_RETAIN | 对于仅在重试后通过,或应用自行修复已变更的页面元素后通过的测试,保存截图和备注。关闭后不为这些测试保留任何内容; 默认开启。 | true |
证据总容量限制 (GB)NEXUS_EVIDENCE_MAX_GB | 所有证据可占用的最大磁盘空间。每次运行后,会永久删除最早的证据,优先删除通过的运行记录,但每项测试都会保留最新一次运行;默认值为 20 GB。 | 20 |
需保留的可用磁盘空间 (GB)NEXUS_MIN_FREE_GB | 磁盘必须保留的可用空间。低于此值时,即使尚未达到总容量限制,也会永久删除最早的证据(设为 0 可关闭此功能);默认值为 10 GB。 | 10 |
运行历史记录长度NEXUS_HISTORY_RETAIN | 为每项测试的每个浏览器保留的历史结果数, 用于生成趋势和图表. 如果测试每天运行多次, 可调高此值; 默认值为 50. | 50 |
隐私 & 隐身
屏蔽广告并防止网站检测到自动化操作.
| 设置 | 功能 | 默认 |
|---|---|---|
隐藏测试的自动化特征NEXUS_STEALTH_ENABLED | 让测试浏览器看起来像普通用户的浏览器,从而能够访问屏蔽机器人的网站。此功能不用于安全扫描或实体手机;默认关闭。 | false |
测试期间屏蔽广告NEXUS_BLOCK_ADS | 在录制和运行测试时阻止广告网络加载,以免广告弹窗遮挡按钮。绝不会拦截您自己的应用; 默认开启,安全扫描不使用此功能。 | true |
Reports
管理层 PDF/HTML 报告.
| 设置 | 功能 | 默认 |
|---|---|---|
报告上的公司名称ORG_ID | PDF 报告上显示的组织名称。首次打开 Studio 时,会从你的个人资料中填入;如果留空,则使用计算机名称。 | Empty |
报告语言NEXUS_PDF_LANGUAGE | 完整运行后生成的可打印摘要报告的语言。可选择英语 (en) 或西班牙语 (es);默认为英语。 | en |
报告署名NEXUS_QA_ENGINEER_NAME | 报告签字确认部分显示的姓名。请设为批准测试结果的人员姓名;默认值为 QA 工程师。 | QA Engineer |
Notifications
通过 Telegram、Slack 和 Teams 发送每项测试的告警.
| 设置 | 功能 | 默认 |
|---|---|---|
每次失败时发送 Telegram 警报NEXUS_TELEGRAM_NOTIFY | 为每项失败的测试发送一条 Telegram 消息。仅在下方同时启用并连接 Telegram 后生效; 默认关闭,因此启用 Telegram 不会导致消息轰炸。 | false |
每次失败发送 Slack 提醒NEXUS_SLACK_NOTIFY | 为每项失败、不稳定、混沌或视觉变化测试发送一条 Slack 消息。仅在下方同时启用并连接 Slack 后生效; 默认关闭。 | false |
测试通过时发送 Telegram 提醒NEXUS_NOTIFY_ON_PASS | 测试通过时也发送 Telegram 消息. 同时还需开启 Telegram 失败提醒, 大型测试套件可能会产生大量消息; 默认关闭. | false |
每次失败时发送 Teams 告警NEXUS_TEAMS_NOTIFY | 为每项失败、不稳定、混沌或出现视觉变化的测试发送 Microsoft Teams 消息. 仅在下方同时启用并连接 Teams 后生效; 默认关闭. | false |
集成
Slack、Teams、Jira、Azure DevOps、GitHub Issues、Telegram。
| 设置 | 功能 | 默认 |
|---|---|---|
将提醒发送到 TelegramTELEGRAM_ENABLED | 启用后, 测试摘要和您分享的文件将发送至外部服务 Telegram. 默认关闭; 如果公司不允许数据离开此计算机, 请保持关闭. | false |
Telegram 机器人访问码TELEGRAM_TOKEN | 你自己的 Telegram 机器人(免费助手账号)的密钥。在 Telegram 中向 @BotFather 发送 /newbot 即可获取;密钥仅保存在此计算机上,绝不会共享。 | 空。仅保存在此电脑上。 |
接收警报的 Telegram 聊天TELEGRAM_CHAT_ID | 接收警报的 Telegram 聊天的标识编号。在设置 → 集成中使用连接功能扫描二维码后,会自动填入。 | Empty |
为失败项创建 Jira 工单JIRA_ENABLED | 测试失败时创建 Jira 缺陷, 并在后续运行中更新. 保存 Jira Connect 时会自动开启此功能, 在该处粘贴来自您的 Jira 的任意链接即可. | false |
Jira 站点地址JIRA_BASE_URL | Jira 的网址,例如 https://yourteam.atlassian.net。将 Jira 中的任意链接粘贴到连接界面后,会自动填入。 | Empty |
Jira 登录邮箱JIRA_EMAIL | 用于登录 Jira 的电子邮件地址。在 Jira 连接中,将其与访问令牌一起输入。 | Empty |
Jira 访问令牌JIRA_API_TOKEN | 允许 Studio 使用你的 Jira 账户的类似密码的代码. 可在 Atlassian 账户的安全 → API 令牌中创建; 它仅保存在此计算机上, 绝不会共享. | 空。仅保存在此电脑上。 |
缺陷工单所属的 Jira 项目JIRA_PROJECT_KEY | 项目中每个工单编号前的短代码,例如 QA-123 中的 QA。在 Jira 连接中选择项目后会自动填入。 | QA |
测试通过时的 Jira 状态JIRA_DONE_TRANSITION | 缺陷对应的测试在所有浏览器中再次通过时,缺陷转入的状态,例如已完成。留空则使用已完成;如果 Jira 中没有此状态,Studio 只会添加评论。 | 完成 |
将完整录制文件附加到工单NEXUS_ISSUE_ATTACH_TRACE | 将技术录制文件和原始日志附加到 Jira 和 Azure 工单中. 默认关闭, 因为其中可能包含 Cookie 和输入的密码, 而项目中的所有人都能打开这些附件. | false |
用于查找漏测缺陷的 Jira 搜索NEXUS_JIRA_ESCAPED_JQL | 用于查找已流入生产环境的缺陷的 Jira 搜索筛选条件, 例如 status = Done AND labels = production. 留空时, 缺陷逃逸指标显示 "未配置". | Empty |
为失败项创建 Azure 工作项AZURE_BOARDS_ENABLED | 测试失败时创建 Azure Boards 工作项 (工单), 并在后续运行时更新. 保存连接 Azure DevOps 的设置后自动启用. | false |
Azure DevOps 组织地址AZURE_DEVOPS_ORG_URL | 组织的网址,例如 https://dev.azure.com/yourcompany。将任意 Azure DevOps 链接粘贴到连接界面后,会自动填入。 | Empty |
Azure DevOps 项目名称AZURE_DEVOPS_PROJECT | 组织中用于接收工作项并运行流水线的项目。在连接 Azure DevOps 中选择项目后会自动填入。 | Empty |
Azure DevOps 访问令牌AZURE_DEVOPS_PAT | 用于 Azure 账户的类似密码的代码 (个人访问令牌), 可在用户设置 → 个人访问令牌中创建. 它仅保存在此计算机上, 绝不会共享. | 空。仅保存在此电脑上。 |
测试失败时的 Azure 工单类型AZURE_BOARDS_WORK_ITEM_TYPE | 测试失败时创建的工作项类型,例如缺陷。该类型必须存在于项目中;留空则使用缺陷。 | Bug |
测试通过时的 Azure 状态AZURE_BOARDS_DONE_STATE | 工作项对应的测试再次通过时,工作项转入的状态,例如已解决。留空则使用已解决;如果项目不允许转入该状态,Studio 只会添加评论。 | Resolved |
在 CI 中运行的 Azure 流水线AZURE_PIPELINE_ID | “在 CI 中运行”所启动的 Azure 流水线编号。在 Azure DevOps 中打开该流水线,然后复制地址栏中 definitionId= 后面的数字。 | Empty |
将提醒发送到 SlackSLACK_ENABLED | 将测试失败、摘要和其他提醒发送到 Slack。默认关闭; 保存 Slack Connect 时会自动开启,还可发送测试消息。 | false |
用于提醒的 Slack 频道SLACK_WEBHOOK_URL | 允许 Studio 向某个频道发送消息的 Slack 私密链接. 可在 Slack → 你的应用 → 传入 Webhook 中创建; 它仅保存在此计算机上, 绝不会共享. | 空。仅保存在此电脑上。 |
向 Microsoft Teams 发送告警TEAMS_ENABLED | 将测试失败信息和摘要发布到 Teams 频道. 默认关闭: 保存 Teams webhook 后即会启用, 并可发送测试消息. | false |
接收告警的 Teams 频道TEAMS_WEBHOOK_URL | 一个私密链接 (webhook), 允许 Studio 向某个 Teams 频道发布消息. 在频道的 ··· 菜单 → 工作流 → “收到 webhook 请求时发布到频道”中创建. | 空。仅保存在此电脑上。 |
为失败的测试创建 GitHub 议题GITHUB_ISSUES_ENABLED | 测试失败时创建 GitHub 议题, 再次失败时添加评论, 测试通过时关闭议题. 保存 GitHub Issues 卡片后启用. | false |
GitHub 访问令牌GITHUB_ISSUES_TOKEN | 类似密码的代码(令牌), 让 Studio 可以在一个仓库中创建议题. 在 GitHub 中创建令牌, 并将议题权限设为读写; 令牌仅保存在此计算机上. | 空。仅保存在此电脑上。 |
用于创建议题的 GitHub 仓库GITHUB_ISSUES_REPO | 接收议题的仓库, 使用 owner/repo 格式, 例如 acme/web. 请从 GitHub Issues 卡片中的列表选择. | Empty |
将工单发送到您自己的系统TICKETS_HOOK_ENABLED | 将每项失败的测试以签名消息的形式发送到您自己的网址,以便您的工具创建工单。默认关闭;还需在工单配置中添加一个“webhook”目标。 | false |
工单系统地址TICKETS_WEBHOOK_URL | 用于以消息形式接收每张工单的 https 网址。该地址仅保存在此计算机上,保存后不再显示。 | 空。仅保存在此电脑上。 |
工单签名密码TICKETS_WEBHOOK_SECRET | 至少包含 16 个字符的密码。每条消息都会使用此密码签名,以便您的系统验证消息确实来自此处。 | 空。仅保存在此电脑上。 |
用于 CI/CD 的 GitHub 令牌GITHUB_CI_TOKEN | 一种类似密码的代码 (令牌), 无需 gh 程序即可将 CI 密钥保存到 GitHub. 请授予其 Secrets: 读写权限; 留空则使用 gh. | 空。仅保存在此电脑上。 |
执行 & 其他
外部工具的第三方密钥.
| 设置 | 功能 | 默认 |
|---|---|---|
Apollo API 密钥APOLLO_API_KEY | Apollo.io 销售联系人服务的密钥, 在 Apollo 账户设置的 API 部分创建. Nexus Studio 中没有功能使用此密钥, 除非您自己的工具需要读取它, 否则请留空. | 空。仅保存在此电脑上。 |
手机屏幕方向NEXUS_EMU_ORIENTATION | 每次在手机上运行时采用竖屏或横屏。留空则保持手机默认的竖屏方向。 | Empty |
手机位置NEXUS_EMU_GEO | 手机报告的位置,格式为纬度,经度(例如 4.711,-74.0721)。网页无需请求权限即可获取此位置。 | Empty |
手机语言NEXUS_EMU_LOCALE | 手机报告的语言和地区,例如 es-CO 或 pt-BR。留空则使用手机自身的设置。 | Empty |
手机时区NEXUS_EMU_TIMEZONE | 手机报告的时区,例如 America/Bogota。留空则使用此计算机的时区。 | Empty |
手机深色模式NEXUS_EMU_COLOR_SCHEME | light、dark 或 no-preference:网页读取到的手机配色设置。 | Empty |
手机减少动态效果NEXUS_EMU_REDUCED_MOTION | reduce 会让网页识别到手机已设置为减少动画;no-preference 则关闭此设置。 | Empty |
为失败的测试创建 Linear 问题LINEAR_ENABLED | 为每项失败的测试创建一个 Linear 问题,再次失败时添加评论,通过时关闭问题。默认关闭;还需在工单设置中添加一个“linear”目标。 | false |
Linear API 密钥LINEAR_API_KEY | 来自 Linear 的个人 API 密钥(设置 → 安全与访问 → 个人 API 密钥)。该密钥仅保存在此计算机上,保存后不再显示。 | 空。仅保存在此电脑上。 |
Linear 团队LINEAR_TEAM_ID | 接收问题的 Linear 团队 ID。每个目标都可通过自己的覆盖设置指定其他团队。 | Empty |
为失败的测试创建 GitLab 议题GITLAB_ISSUES_ENABLED | 为每项失败的测试创建一个 GitLab 议题,再次失败时添加备注,通过时关闭议题。默认关闭;还需在工单设置中添加一个“gitlab”目标。 | false |
GitLab 议题访问令牌GITLAB_ISSUES_TOKEN | 具有 api 权限范围的 GitLab 访问令牌。该令牌仅通过 https 发送到您的 GitLab,仅保存在此计算机上,保存后不再显示。 | 空。仅保存在此电脑上。 |
接收议题的 GitLab 项目GITLAB_ISSUES_PROJECT | 接收议题的项目:填写项目编号或路径,例如 group/name。GitLab 地址与 CI/CD 使用的地址相同(默认为 gitlab.com)。 | Empty |
通过 PagerDuty 呼叫值班人员PAGERDUTY_ENABLED | 为每项失败的测试触发一条 PagerDuty 告警,测试再次通过时将其标记为已解决。默认关闭;还需在工单设置中添加一个“pagerduty”目标。 | false |
PagerDuty 集成密钥PAGERDUTY_ROUTING_KEY | 需要触发告警的 PagerDuty 服务的 Events API v2 集成密钥。该密钥仅保存在此计算机上,保存后不再显示。 | 空。仅保存在此电脑上。 |
通过 Opsgenie 向值班人员发送告警OPSGENIE_ENABLED | 为每项失败的测试创建一条 Opsgenie 告警,再次失败时添加备注,通过时关闭告警。默认关闭;还需添加一个“opsgenie”目标。 | false |
Opsgenie API 密钥OPSGENIE_API_KEY | 具有创建和关闭告警权限的 Opsgenie API 密钥。该密钥仅保存在此计算机上,保存后不再显示。 | 空。仅保存在此电脑上。 |
Opsgenie 区域OPSGENIE_API_URL | https://api.opsgenie.com;如果您的 Opsgenie 账户位于欧盟,则使用 https://api.eu.opsgenie.com。 | https://api.opsgenie.com |
将结果发送到 TestRailTESTRAIL_ENABLED | 每次运行结束时,在 TestRail 中创建一次测试运行,纳入所有通过 // nexus:testrail C123 注释指定了用例的测试,并提交通过或失败的结果。默认关闭。 | false |
TestRail 地址TESTRAIL_URL | 您的 TestRail 站点,例如 https://yourcompany.testrail.io。仅支持 https。 | Empty |
TestRail 用户TESTRAIL_USER | 用于提交结果的 TestRail 账户的电子邮箱。 | Empty |
TestRail API 密钥TESTRAIL_API_KEY | 该 TestRail 账户的 API 密钥(我的设置 → API 密钥)。密钥仅保存在此计算机上,保存后不再显示。 | 空。仅保存在此电脑上。 |
TestRail 项目TESTRAIL_PROJECT_ID | 接收测试运行结果的 TestRail 项目编号(地址中 P 后面的数字,不含 P)。 | Empty |