# @github/browser-support 中文文档

规范地址：https://npmcn.com/package/%40github/browser-support/

版本：4\.5\.3
npm 元数据更新时间：2026-11-04T19:00:44.994Z
中文译文更新时间：2026-11-16T11:08:12.595Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40github/browser-support
原文对照：https://npmcn.com/package/%40github/browser-support/?lang=original
项目主页：https://github.github.io/browser-support
源码仓库：https://github.com/github/browser-support

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

- 包体积（解压后）：67.3 kB，47 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：2 个
- 首次发布：2022-02-08T11:54:22.319Z
- 最新版本发布：2026-11-04T19:00:44.578Z
- 近 30 天下载量：13925（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：35（近 12 个月 6 个）

## 中文简介

多填充器和可控浏览器检测

## 安装

```sh
npm install @github/browser-support
```

也可以使用：`pnpm add @github/browser-support`、`yarn add @github/browser-support`、`bun add @github/browser-support`

## README

# 浏览器支持

这个库允许网站与较旧的浏览器保持相容性,这些浏览器没有执行更新的功能. 它使用 [多元填充器](https://developer.mozilla.org/en-US/docs/Glossary/Polyfill) 用于小型新特性,加函数,以确定浏览器是支持一组本地特性还是支持多填充.

如果您想要查看您当前使用工具的浏览器的特性, 您 [可以访问文档网站](https://github.github.com/browser-support/) 它显示一个可检测浏览器中原生支持哪些特性的相容表.

### 这个怎么用在GitHub上?

我们在GitHub.com上使用所有这些多填充. 我们也使用 `isSupported()` 函数可以确定浏览器是否符合我们期望的最小功能集,从中返回的浏览器 `isSupported()` 请不要向后端监控发送错误或统计数据.

## 安装

```
$ npm install @github/browser-support
```

## 使用量

### 联合来文

```js
import {isSupported, isPolyfilled, apply} from '@github/browser-support'

// Check if a browser is supported
if (!isSupported()) {
  apply()
  console.assert(isSupported() === true)
  console.assert(isPolyfilled() === true)
}
```

## 发展

```
npm install
npm test
```

## Dotcom 中的更新浏览器支持

在升级期间,必须确保向哨兵报告的浏览器出错不会被打乱. 使用以下步骤验证此功能:

### 审查实验室测试

-   创建 PR 升级 `browser-support` dotcom的版本.
-   从您的浏览器触发错误 `review-lab` 在哨兵中报告并证实:
    -   附录 `#b00m` 给您的 `review-lab` URL(例如:. `https://branchname.review-lab.github.com#b00m`)并刷新页面.
    -   确认错误报告于 [哨兵队](https://github.sentry.io/issues/?environment=review-lab&groupStatsPeriod=auto&project=1890375&query=b00m&referrer=issue-list&statsPeriod=5m)。 。 。 .
    -   在Chrome、Firefox、Edge和Opera中执行这些步骤。 注:Safari目前没有报告出错,原因是: [未决问题](https://github.com/github/web-systems/issues/3162)。 。 。 .

### 生产部署

-   检查 [浏览器报告](https://app.datadoghq.com/monitors/168685099) 显示器.
    -   如果所报浏览器出错率下降,显示器将在 [#网络系统 -ops](https://github-grid.enterprise.slack.com/archives/C046W1V95FV) 频道.
-   部署到金丝雀后:
    -   通过附加触发浏览器出错 `#b00m` 转到您的 URL.
    -   确认错误报告于 [金丝雀哨兵](https://github.sentry.io/issues/?environment=canary&groupStatsPeriod=auto&project=1890375&query=b00m&referrer=issue-list&statsPeriod=5m)。 。 。 .
-   部署到生产后:
    -   通过附加触发浏览器出错 `#b00m` 转到您的 URL.
    -   确认错误报告于 [哨兵生产](https://github.sentry.io/issues/?environment=production&groupStatsPeriod=auto&project=1890375&query=b00m&referrer=issue-list&statsPeriod=5m)。 。 。 .
    -   检查 [浏览器报告监视器](https://app.datadoghq.com/monitors/168685099) 以确保错误报告率没有异常.

## 捐款

### 添加多填充器

请不要为第3阶段或以下的ECMA特性添加任何多填充. 我们 _仅限_ 想要从 ECMAScript 中的多填充特性,即第四阶段(即将列入新的年份规格)或已经指定.

### 删除多填充

只有在征求了秘书处的意见之后,才能拆除多填 `@github/web-systems` 由谁来决定是否可以去除多填充。 这个代码是用来保持轻量级的, 我们不想运送数十克的多填充.

随着多填充物被去除,也许值得在 `baseSupport` const,以确保我们的基线与浏览器支持矩阵相移动.

## 许可证

以麻省理工学院许可证分发。 详情见LICENSE.

## 常见问题

### @github/browser-support 是什么？

多填充器和可控浏览器检测

### 如何安装 @github/browser-support？

在项目目录运行 npm install @github/browser-support，或使用 pnpm add / yarn add / bun add。

### @github/browser-support 支持 TypeScript 吗？

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

### @github/browser-support 支持 ESM 还是 CommonJS？

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

### @github/browser-support 可以商用吗？

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

### @github/browser-support 的下载量有多少？

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

### @github/browser-support 还在维护吗？

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

