@amazon/vinyl-browserstack

中文文档
5.0.0发布于 2026/11/16Apache-2.0TypeScriptES Module构建来源已验证近 30 天下载 2052

在Selenium/WebDriver上运行浏览器Jasmine套件,跨越浏览器Stack真实浏览器,或者在Playwright浏览器和Safari中本地运行.

中文使用文档
文档目录3 节
  1. 如何运作
  2. 使用量
  3. 本地浏览器

@amazon/vinyl-浏览器tack

运行一个 浏览器茉莉花 浏览器间套接字Stack 真实浏览器 硒/网络司机 (单位:千美元)hub-cloud.browserstack.com/wd/hub),或当地输入 Playwright的浏览器和Safari.

如何运作

消耗软件包构建浏览器测试页面( 它的茉莉花靴子 + specs) 并服务它。 这个跑者:

  1. 启动本地快递服务器( 为测试页面服务) 加 a 记者 REST API 密码 浏览器套件显示进度和日志到 .
  2. 启动 浏览器Stack 本地 隧道 隧道.
  3. 构建一个真实 Web 驱动程序 每个浏览器的会话——平行于 账户的可用会话预算 —— 并使用 (单位:千美元) ?reportApi= 查询参数,然后单击页面的启动提示(触摸水龙头) iOS上),因此媒体可以播放未被调用.
  4. 以周期性无操作 WebDriver 命令保持每个会话的活性( 规格) 运行无驱动交互的浏览器, 因此会话的闲置定时器必须 重新明确设置——REST状态投票不重新设置),并强制执行a 本地最大期限上限, 因为 WebDriver 没有服务器侧工人超时 .
  5. 光谱传入/ 失败汇总, 写 bStackLogs/<sessionId>.log 百分比 ,并且每场会话通过 Automate REST API 通过/失效后盖章.

这是遗产的WebDriver继任者 /5/worker (JS测试)运输 内 @amazon/vinyl-build-utils它重新使用该软件包的框架不可知性 原始(记者 API,快递服务器,本地地道,自动客户端, 证书,记录),并只交换运输.

与遗产传输不同, WebDriver 会话流行浏览器Stack 仪表板 控制台日志 选项卡(仅色; bStackLogs/ 仍为完整 交叉浏览器日志源).

使用量

import { runSeleniumBrowserStackAndExit } from '@amazon/vinyl-browserstack'
import { vinylDefaultBrowserStackOptions } from '@amazon/vinyl-build-utils'

runSeleniumBrowserStackAndExit({
    ...vinylDefaultBrowserStackOptions,
    workerCommon: { project: 'MyProject' },
})

全权证书来自 options.credentials 或 BROWSERSTACK_USERNAME 编号 : BROWSERSTACK_ACCESS_KEY 环境变量(a) .env 文件被授予荣誉).

本地浏览器

runLocalBrowsersAndExit 服务同一测试页,并运行于此机器 在Playwright的Chrimium、Firefox和WebKit中以及在Safari 猎杀机,所有一次,除非 --serial 通过,单击启动提示 中包含可信赖的输入。 它运行每个谱并打印出谱数,种子,和 每个浏览器失败, 任何失败时都会退出非零 .

import { runLocalBrowsersAndExit } from '@amazon/vinyl-browserstack'
import { vinylDefaultBrowserStackOptions } from '@amazon/vinyl-build-utils'

runLocalBrowsersAndExit({ server: vinylDefaultBrowserStackOptions.server })

Playwright 是可选的对等依赖; 添加 playwright 作为依赖性 并用 npx playwright install萨法里被跳过 信件, 除非启用远程自动化( 开发 > “ Allow 远程” 自动化").

版本与发布记录

@amazon/vinyl-browserstack 共发布 35 个版本,首次发布于 2026/09/05;过去 12 个月发布了 35 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
5.0.0latest2026/11/16今天
4.1.1-next.20261115174554next2026/11/16今天
4.1.1-next.202611151724472026/11/16今天
4.1.1-next.202611151644392026/11/16今天
4.1.1-next.202611150013552026/11/151 天前
4.1.1-next.202611131749092026/11/142 天前

关于 @amazon/vinyl-browserstack 的常见问题

@amazon/vinyl-browserstack 是什么?

在Selenium/WebDriver上运行浏览器Jasmine套件,跨越浏览器Stack真实浏览器,或者在Playwright浏览器和Safari中本地运行.

如何安装 @amazon/vinyl-browserstack?

在项目目录运行 npm install @amazon/vinyl-browserstack,或使用 pnpm add / yarn add / bun add。

@amazon/vinyl-browserstack 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@amazon/vinyl-browserstack 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@amazon/vinyl-browserstack 可以商用吗?

@amazon/vinyl-browserstack 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@amazon/vinyl-browserstack 的下载量有多少?

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

@amazon/vinyl-browserstack 还在维护吗?

最新版本 5.0.0 发布于 2026/11/16(今天);至今共发布 35 个版本,其中过去 12 个月发布了 35 个;首次发布于 2026/09/05。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。