# @browserless/lighthouse 中文文档

规范地址：https://npmcn.com/package/%40browserless/lighthouse/

版本：14\.1\.2
npm 元数据更新时间：2026-11-03T15:38:28.852Z
中文译文更新时间：2026-11-08T16:37:32.993Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40browserless/lighthouse
原文对照：https://npmcn.com/package/%40browserless/lighthouse/?lang=original
项目主页：https://browserless.js.org/
源码仓库：https://github.com/microlinkhq/browserless#master

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

- 包体积（解压后）：10.6 kB，6 个文件
- 模块格式：CommonJS
- TypeScript 类型：未声明
- Node.js 要求：\>= 24
- 运行依赖：2 个
- 首次发布：2020-03-02T20:12:46.574Z
- 最新版本发布：2026-11-03T15:38:28.475Z
- 近 30 天下载量：2824（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：200（近 12 个月 38 个）

## 中文简介

使用无头Chrome对网站进行谷歌灯塔审计. 获得性能,无障碍,和SEO的度量标准.

## 安装

```sh
npm install @browserless/lighthouse
```

也可以使用：`pnpm add @browserless/lighthouse`、`yarn add @browserless/lighthouse`、`bun add @browserless/lighthouse`

## README

![browserless](https://github.com/microlinkhq/browserless/raw/master/static/logo-banner.png#gh-light-mode-only) ![browserless](https://github.com/microlinkhq/browserless/raw/master/static/logo-banner-light.png#gh-dark-mode-only)  
  
[![Powered by microlink.io](https://img.shields.io/badge/powered_by-microlink.io-blue?style=flat-square&color=%23EA407B)](https://microlink.io/) ![Last version](https://img.shields.io/github/tag/microlinkhq/browserless.svg?style=flat-square) [![Coverage Status](https://img.shields.io/coveralls/microlinkhq/browserless.svg?style=flat-square)](https://coveralls.io/github/microlinkhq/browserless) [![NPM Status](https://img.shields.io/npm/dm/browserless.svg?style=flat-square)](https://www.npmjs.org/package/browserless)  
  

> @浏览器无/灯塔:使用木偶机进行无浏览器灯塔集成.

见 [灯塔部分](https://browserless.js.org/#/?id=lighthouse) 我们的网站有更多信息.

## 安装

使用 npm :

```sh
npm install @browserless/lighthouse --save
```

## 关于

此软件包提供 **谷歌灯塔集成** 对于无浏览器,允许您使用您现有的无浏览器设置运行性能,访问,SEO,以及任何URL上的最佳做法审核.

### 这个软件包做什么

这个 `@browserless/lighthouse` 软件包允许您 :

-   **运行灯塔审计** 具有充分性能、可获取性、标准作业程序和PWA分析
-   **生成报告** 以 JSON 、 HTML 或 CSV 格式
-   **使用灯塔预设** 用于桌面或移动配置
-   **定制审计** 选择特定类别或跳过某些检查
-   **重用您已有的无浏览器实例** 审计

### 使用量

```js
const createLighthouse = require('@browserless/lighthouse')
const createBrowser = require('browserless')

// Create a browserless instance
const browser = createBrowser()

// Create the lighthouse function with teardown support
const lighthouse = createLighthouse(async teardown => {
  const browserless = await browser.createContext()
  teardown(() => browserless.destroyContext())
  return browserless
})

// Run an audit
const report = await lighthouse('https://example.com')
console.log(report.categories.performance.score)
```

### 选项

| 选项 | 类型 | 默认 | 说明 |
| --- | --- | --- | --- |
| `output` | `string` | `'json'` | 报告格式 : `'json'`, (中文(简体) ), `'html'`,或 `'csv'` |
| `timeout` | `number` | —— 说 | 审计超时( 毫秒) |
| `preset` | `string` | —— 说 | 灯塔预设: `'lr-desktop'`, (中文(简体) ), `'lr-mobile'`等 (中文(简体) ). |
| `flags` | `object` | —— 说 | [灯塔旗帜](https://github.com/GoogleChrome/lighthouse/blob/main/docs/configuration.md) |
| `onlyAudits` | `string[]` | —— 说 | 只进行特定审计 |
| `skipAudits` | `string[]` | —— 说 | 略去具体审计 |
| `onlyCategories` | `string[]` | —— 说 | 只运行特定类别 |

### 输出格式

```js
// JSON (default) - returns the Lighthouse Result object (lhr)
const jsonReport = await lighthouse(url, { output: 'json' })
console.log(jsonReport.categories.performance) // 0.95

// HTML - returns the full HTML report as a string
const htmlReport = await lighthouse(url, { output: 'html' })
await fs.writeFile('report.html', htmlReport)

// CSV - returns CSV-formatted data
const csvReport = await lighthouse(url, { output: 'csv' })
```

### 灯塔预设

常见配置使用内置灯塔预设:

```js
// Desktop configuration (higher viewport, no throttling)
const report = await lighthouse(url, { preset: 'lr-desktop' })

// Mobile configuration (smaller viewport, CPU/network throttling)
const report = await lighthouse(url, { preset: 'lr-mobile' })
```

### 定制审计

```js
// Run only specific audits
const report = await lighthouse(url, {
  onlyAudits: ['first-contentful-paint', 'largest-contentful-paint']
})

// Run only specific categories
const report = await lighthouse(url, {
  onlyCategories: ['performance', 'accessibility']
})

// Skip specific audits
const report = await lighthouse(url, {
  skipAudits: ['uses-http2', 'bf-cache']
})
```

### 报告结构(JSON)

在使用JSON输出时,报告包括:

```js
const report = await lighthouse(url)

// Categories with scores (0-1)
report.categories.performance.score      // Performance score
report.categories.accessibility.score    // Accessibility score
report.categories.seo.score              // SEO score
report.categories['best-practices'].score // Best practices score
report.categories.pwa.score              // PWA score (if applicable)

// Individual audits
report.audits['first-contentful-paint'].numericValue  // FCP in ms
report.audits['largest-contentful-paint'].numericValue // LCP in ms
report.audits['cumulative-layout-shift'].numericValue  // CLS score
report.audits['total-blocking-time'].numericValue      // TBT in ms

// Configuration used
report.configSettings
```

### 如何适合在单体

这个 **扩展功能包** 业绩审计:

| 消费者 | 目的 |
| --- | --- |
| `@browserless/cli` | 权力 `browserless lighthouse` 命令 |

### 依赖关系

| 软件包 | 目的 |
| --- | --- |
| `lighthouse` | 谷歌灯塔核心图书馆 |

## 许可证

**@ 无眉/ 灯塔** © [微链接](https://microlink.io/),在 [麻省理工学院](https://github.com/microlinkhq/browserless/blob/master/LICENSE.md) 执照.  
作者和维护者 [微链接](https://microlink.io/) 由来自 [捐助者](https://github.com/microlinkhq/browserless/contributors)。 。 。 .

这个 [标志](https://thenounproject.com/term/browser/288309/) 设计由 [辛赫工作室](https://xinh.studio/)。 。 。 .

> [微链接.io](https://microlink.io/) • GitHub 软件 [微链克](https://github.com/microlinkhq) • X [@microlinkhq (英语)](https://x.com/microlinkhq)

## 常见问题

### @browserless/lighthouse 是什么？

使用无头Chrome对网站进行谷歌灯塔审计\. 获得性能,无障碍,和SEO的度量标准\.

### 如何安装 @browserless/lighthouse？

在项目目录运行 npm install @browserless/lighthouse，或使用 pnpm add / yarn add / bun add。

### @browserless/lighthouse 支持 TypeScript 吗？

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

### @browserless/lighthouse 支持 ESM 还是 CommonJS？

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

### @browserless/lighthouse 需要什么版本的 Node\.js？

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

### @browserless/lighthouse 可以商用吗？

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

### @browserless/lighthouse 的下载量有多少？

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

### @browserless/lighthouse 还在维护吗？

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