# @flex-development/is-builtin 中文文档

规范地址：https://npmcn.com/package/%40flex-development/is-builtin/

版本：3\.2\.0
npm 元数据更新时间：2024-10-31T23:48:38.606Z
中文译文更新时间：2026-11-14T22:34:11.171Z
软件包许可：BSD-3-Clause

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

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

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

- 包体积（解压后）：73.7 kB，16 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：1 个
- 首次发布：2022-10-08T19:56:11.521Z
- 最新版本发布：2024-10-31T23:48:38.132Z
- 近 30 天下载量：3042（2026-10-15 至 2026-11-13，npm 官方下载统计）
- 已发布版本数：6（近 12 个月 0 个）

## 中文简介

模块的通用空投替换。 is Builtin

## 安装

```sh
npm install @flex-development/is-builtin
```

也可以使用：`pnpm add @flex-development/is-builtin`、`yarn add @flex-development/is-builtin`、`bun add @flex-development/is-builtin`

## README

# 已建进

[![github release](https://img.shields.io/github/v/release/flex-development/is-builtin.svg?include_prereleases&sort=semver)](https://github.com/flex-development/is-builtin/releases/latest) [![npm](https://img.shields.io/npm/v/@flex-development/is-builtin.svg)](https://npmjs.com/package/@flex-development/is-builtin) [![codecov](https://codecov.io/github/flex-development/is-builtin/branch/main/graph/badge.svg?token=MQ427OD7XD)](https://codecov.io/github/flex-development/is-builtin) [![module type: esm](https://img.shields.io/badge/module%20type-esm-brightgreen)](https://github.com/voxpelli/badges-cjs-esm) [![license](https://img.shields.io/github/license/flex-development/is-builtin.svg)](https://npmcn.com/package/%40flex-development/is-builtin/LICENSE.md) [![conventional commits](https://img.shields.io/badge/-conventional%20commits-fe5196?logo=conventional-commits&logoColor=ffffff)](https://conventionalcommits.org/) [![typescript](https://img.shields.io/badge/-typescript-3178c6?logo=typescript&logoColor=ffffff)](https://typescriptlang.org/) [![vitest](https://img.shields.io/badge/-vitest-6e9f18?style=flat&logo=vitest&logoColor=ffffff)](https://vitest.dev/) [![yarn](https://img.shields.io/badge/-yarn-2c8ebb?style=flat&logo=yarn&logoColor=ffffff)](https://yarnpkg.com/)

通用空投替换 [`module.isBuiltin`](https://nodejs.org/api/module.html#moduleisbuiltinmodulename)

## 目录

-   [这是什么?](https://npmcn.com/package/%40flex-development/is-builtin/#readme-what-is-this)
-   [我什么时候用这个?](https://npmcn.com/package/%40flex-development/is-builtin/#readme-when-should-i-use-this)
-   [安装](https://npmcn.com/package/%40flex-development/is-builtin/#readme-install)
-   [使用](https://npmcn.com/package/%40flex-development/is-builtin/#readme-use)
-   [API 密码](https://npmcn.com/package/%40flex-development/is-builtin/#readme-api)
    -   [`isBuiltin(m)`](https://npmcn.com/package/%40flex-development/is-builtin/#readme-isbuiltinm)
-   [类型](https://npmcn.com/package/%40flex-development/is-builtin/#readme-types)
-   [相关](https://npmcn.com/package/%40flex-development/is-builtin/#readme-related)
-   [贡献](https://npmcn.com/package/%40flex-development/is-builtin/#readme-contribute)

## 这是什么?

此软件包是通用的 drop- in 取代 [`module.isBuiltin`](https://nodejs.org/api/module.html#moduleisbuiltinmodulename)。 。 。 .

## 我什么时候用这个?

此软件包导出单个函数, 用于确定模块是否为 [内建模块](https://nodejs.org/api/esm.html#builtin-modules)。 建设 模块是由Node.js维护的核心模块. 可以用名称或使用 [`node:` 網址](https://nodejs.org/api/esm.html#node-imports)。 。 。 .

## 安装

这个软件包是 [仅限无害环境管理](https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c)。 。 。 .

在Node.js(第18版+)中与 [线条](https://yarnpkg.com/)数字 :

```sh
yarn add @flex-development/is-builtin
```

> 见 [Git - 协议QQ Yarn](https://yarnpkg.com/protocol/git)  关于从Git安装的细节.

在德诺与 [`esm.sh`](https://esm.sh/)数字 :

```ts
import { isBuiltin } from 'https://esm.sh/@flex-development/is-builtin'
```

在浏览器中 [`esm.sh`](https://esm.sh/)数字 :

```html
<script type="module">
  import { isBuiltin } from 'https://esm.sh/@flex-development/is-builtin'
</script>
```

## 使用

```ts
import { isBuiltin } from '@flex-development/is-builtin'

isBuiltin('@flex-development/is-builtin') // false
isBuiltin('assert')                       // true
isBuiltin('fs/promises')                  // true
isBuiltin(new URL('node:os'))             // true
isBuiltin('node:module')                  // true
isBuiltin('node:test/reporters')          // true
isBuiltin('test')                         // false
isBuiltin(null)                           // false
```

## API 密码

此软件包导出标识符 [`isBuiltin`](https://npmcn.com/package/%40flex-development/is-builtin/#readme-isbuiltinm)。 。 。 .

默认导出也是 `isBuiltin`。 。 。 .

### `isBuiltin(m)`

检查是否 `m` 参考文献 a [内建模块](https://nodejs.org/api/esm.html#builtin-modules)。 。 。 .

> 👉 **说明**数字 : `m` 将转换为字符串(`String(m)`) 检查前.

#### 参数

-   `m` (单位:千美元)`unknown`\- 检查的东西

#### 回返

`true` 若为 `m` 内置模块中的参考文献, `false` 否则.

## 类型

此软件包已全部输入 [类型脚本](https://www.typescriptlang.org/)。 。 。 .

## 相关

-   [`builtin-modules`](https://github.com/flex-development/builtin-modules) - 通用空投替换 [`module.builtinModules`](https://nodejs.org/api/module.html#modulebuiltinmodules)

## 贡献

见 [`CONTRIBUTING.md`](https://npmcn.com/package/%40flex-development/is-builtin/CONTRIBUTING.md)。 。 。 .

这个项目有一个 [行为守则](https://npmcn.com/package/%40flex-development/is-builtin/CODE_OF_CONDUCT.md)通过与该存储库、组织或 你同意遵守它的规定.

## 常见问题

### @flex-development/is-builtin 是什么？

模块的通用空投替换。 is Builtin

### 如何安装 @flex-development/is-builtin？

在项目目录运行 npm install @flex-development/is-builtin，或使用 pnpm add / yarn add / bun add。

### @flex-development/is-builtin 支持 TypeScript 吗？

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

### @flex-development/is-builtin 支持 ESM 还是 CommonJS？

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

### @flex-development/is-builtin 可以商用吗？

@flex-development/is-builtin 使用 BSD-3-Clause 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。另外不得用原作者名义为衍生产品背书。以上为概括，不构成法律意见，请以许可原文为准。

### @flex-development/is-builtin 的下载量有多少？

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

### @flex-development/is-builtin 还在维护吗？

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

