# @accesslint/chrome 中文文档

规范地址：https://npmcn.com/package/%40accesslint/chrome/

版本：0\.2\.0
npm 元数据更新时间：2026-06-02T02:32:59.231Z
中文译文更新时间：2026-11-06T12:13:32.918Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：139 kB，6 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- 运行依赖：2 个
- 首次发布：2026-06-02T00:34:33.153Z
- 最新版本发布：2026-06-02T02:32:58.971Z
- 近 30 天下载量：3250（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：4（近 12 个月 4 个）

## 中文简介

确保可调试的Chrome为CDP HTTP发现API服务,并管理其生命周期. 发射离散,使其超过发射程序;暴露出保证/停止/状态.

## 安装

```sh
npm install @accesslint/chrome
```

也可以使用：`pnpm add @accesslint/chrome`、`yarn add @accesslint/chrome`、`bun add @accesslint/chrome`

## README

# @ accesslint/ 颜色

确保 **可调试的染色体** accessLint的现场DOM审核可以驱动 管理它的生命周期.

AccessLint CLI (英语:`@accesslint/cli`)是纯 CDP 客户端: 给它调试 端点和一个 URL, 它会注入 `@accesslint/core` 审计。 没有 发射克洛姆 这个软件包填补了这一空白,并发射了Chrome **分离** 这样 它的寿命超过启动它的一发发射装置过程.

## 为什么一个单独的包

`chrome-launcher`是因为 `launch()` 将克洛姆的一生与召唤过程联系起来, 这对一个错误 `npx`\- 式一发:当命令退出时,Chrome会 在审计连接之前死亡。 因此,这个包 产出克罗梅脱落,记录 它的 pid + 丢弃 profile 到状态文件, 并暴露明确 `stop`。 。 。 .

它也编码 **HTTP 发现陷阱**: 通过 DevTools 打开的克罗姆 复选框(或 `chrome-devtools-mcp`)将调试端口打开,但只服务于 a 韦伯索克- `chrome-remote-interface` 不能开它。 此软件包处理一个 只有在 `/json/version` 回答,从来没有在赤裸的TCP探测器. 当针入端口时( W)`--port` 或者说 `ACCESSLINT_CDP_PORT`如果端口是 蹲下,所以呼叫者要对着他们要求的港口,一个没有钉住的 `ensure` 步骤改为下一个自由端口.

## 使用量

```bash
# Get-or-launch a driveable Chrome; prints its endpoint as JSON.
npx @accesslint/chrome ensure
# → {"ok":true,"mode":"launched","host":"127.0.0.1","port":9222,"pid":1234,"managed":true,...}

# Idempotent: a second ensure attaches to the running one.
npx @accesslint/chrome ensure        # → {"mode":"attached",...}

# Tear it down.
npx @accesslint/chrome stop --all
```

### 图标

| 命令 | 它会做什么 |
| --- | --- |
| `ensure` | 端口的可驱动克洛姆,或发射可分离克洛姆. |
| `stop` | 杀死管理实例( E)`--port`) 或所有(`--all`)并取净. |

### 选项

```
-p, --port <n>   CDP port to attach to / launch on (default 9222)
    --headed     Launch a visible Chrome instead of headless (ensure)
    --download   Download a managed Chrome for Testing if none is installed (ensure)
    --all        Stop every managed instance (stop)
```

如果默认端口被一个 **不可驱动** Chrome( 复选框模式) , 一个没有标记的 `ensure` 步骤至自由端口并报告实际端口——读取 `port` 从它的 JSON 输出。 如果你把那个端口钉住 `--port`, (中文(简体) ), `ensure` 失败; 释放端口或通过另一个端口 .

默认 `ensure` 使用系统Chrome(`CHROME_PATH` 或平台搜索) 如果找不到, 则失败 。 过 `--download` (或设置) `ACCESSLINT_CHROME_DOWNLOAD=1`(中文(简体) ) 回到被钉住的地上 **测试颜色** 通过 `@puppeteer/browsers` 输入缓存目录。 下载(~170MB)一次 首先使用; 后运行再使用缓存二进制 。 一个系统Chrome,当存在时, 总是取胜——下载只是回放.

### 环境

```
ACCESSLINT_CDP_PORT         default port
CHROME_PATH                 override Chrome binary discovery
ACCESSLINT_CHROME_DOWNLOAD   1/true to enable the Chrome for Testing fallback
ACCESSLINT_CHROME_CACHE_DIR  where downloaded Chrome is cached (default ~/.cache/accesslint-chrome)
```

## 图书馆 API

```ts
import { ensure, stop } from "@accesslint/chrome";

const chrome = await ensure({ port: 9222 }); // { mode, host, port, pid, managed, ... }
// … run an audit against chrome.host:chrome.port …
await stop({ port: chrome.port });
```

## 许可证

麻省理工学院

## 常见问题

### @accesslint/chrome 是什么？

确保可调试的Chrome为CDP HTTP发现API服务,并管理其生命周期\. 发射离散,使其超过发射程序;暴露出保证/停止/状态\.

### 如何安装 @accesslint/chrome？

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

### @accesslint/chrome 支持 TypeScript 吗？

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

### @accesslint/chrome 支持 ESM 还是 CommonJS？

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

### @accesslint/chrome 可以商用吗？

@accesslint/chrome 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @accesslint/chrome 的下载量有多少？

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

### @accesslint/chrome 还在维护吗？

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