# @amazon/vinyl-browserstack 中文文档

规范地址：https://npmcn.com/package/%40amazon/vinyl-browserstack/

版本：5\.0\.0
npm 元数据更新时间：2026-11-16T02:15:10.441Z
中文译文更新时间：2026-11-16T03:09:30.508Z
软件包许可：Apache-2\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40amazon/vinyl-browserstack
原文对照：https://npmcn.com/package/%40amazon/vinyl-browserstack/?lang=original
项目主页：https://github.com/amazonmusic/vinyl#readme
源码仓库：https://github.com/amazonmusic/vinyl

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：139 kB，27 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：3 个
- peer 依赖：playwright ^1\.50\.0
- 首次发布：2026-09-04T18:04:33.663Z
- 最新版本发布：2026-11-16T02:15:10.031Z
- 近 30 天下载量：2052（2026-10-06 至 2026-11-04，npm 官方下载统计）
- 已发布版本数：35（近 12 个月 35 个）

## 中文简介

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

## 安装

```sh
npm install @amazon/vinyl-browserstack
```

也可以使用：`pnpm add @amazon/vinyl-browserstack`、`yarn add @amazon/vinyl-browserstack`、`bun add @amazon/vinyl-browserstack`

## README

# @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/` 仍为完整 交叉浏览器日志源).

## 使用量

```ts
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` 通过,单击启动提示 中包含可信赖的输入。 它运行每个谱并打印出谱数,种子,和 每个浏览器失败, 任何失败时都会退出非零 .

```ts
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 是什么？

在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 和提交记录判断。

