# is-descriptor 中文文档 规范地址：https://npmcn.com/package/is-descriptor/ 版本：3\.1\.2 npm 元数据更新时间：2026-05-11T15:00:18.825Z 中文译文更新时间：2026-11-05T16:45:48.594Z 软件包许可：MIT 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/is-descriptor 原文对照：https://npmcn.com/package/is-descriptor/?lang=original 项目主页：https://github.com/inspect-js/is-descriptor 源码仓库：https://github.com/inspect-js/is-descriptor ## 关键信息（来自 npm 元数据） - 包体积（解压后）：34.9 kB，12 个文件 - 模块格式：CommonJS - TypeScript 类型：未声明 - Node.js 要求：\>= 0\.4 - 运行依赖：4 个 - 首次发布：2015-08-31T06:08:04.328Z - 最新版本发布：2026-05-11T15:00:18.724Z - 近 30 天下载量：135858055（2026-10-05 至 2026-11-03，npm 官方下载统计） - 已发布版本数：18（近 12 个月 3 个） ## 中文简介 如果一个值具有有效的 JavaScript 描述符的特性, 返回 True 。 用于数据描述符和存取符描述符的工作. ## 安装 ```sh npm install is-descriptor ``` 也可以使用：`pnpm add is-descriptor`、`yarn add is-descriptor`、`bun add is-descriptor` ## README # 是描述符 [![Version Badge](https://versionbadg.es/inspect-js/is-descriptor.svg)](https://npmjs.org/package/is-descriptor) [![github actions](https://img.shields.io/github/check-runs/inspect-js/is-descriptor/main)](https://github.com/inspect-js/is-descriptor/actions) [![coverage](https://codecov.io/gh/inspect-js/is-descriptor/branch/main/graphs/badge.svg)](https://app.codecov.io/gh/inspect-js/is-descriptor/) [![License](https://img.shields.io/npm/l/is-descriptor.svg)](https://npmcn.com/package/is-descriptor/LICENSE) [![Downloads](https://img.shields.io/npm/dm/is-descriptor.svg)](https://npm-stat.com/charts.html?package=is-descriptor) [![npm badge](https://nodei.co/npm/is-descriptor.png?downloads=true&stars=true)](https://npmjs.org/package/is-descriptor) > 如果一个值具有有效的 JavaScript 描述符的特性, 返回 True 。 完全完成的数据描述符和存取符描述符的工程. ## 使用量 ```js const isDescriptor = require('is-descriptor'); const assert = require('assert'); const defaults = { configurable: false, enumerable: false }; const dataDefaults = { ...defaults, writable: false}; assert.ok(isDescriptor({ ...dataDefaults, value: 'foo' })); assert.ok(isDescriptor({ ...defaults, get() {}, set() {} })); assert.ok(!isDescriptor({ ...defaults, get: 'foo', set() {} })); ``` 您也可以通过传递对象作为第一个参数和属性名来检查描述符(`string`作为第二个论点. ```js const obj = { foo: 'abc' }; Object.defineProperty(obj, 'bar', { value: 'xyz' }); Reflect.defineProperty(obj, 'baz', { value: 'xyz' }); assert.equal(isDescriptor(obj, 'foo'), true); assert.equal(isDescriptor(obj, 'bar'), true); assert.equal(isDescriptor(obj, 'baz'), true); ``` ## 实例 ### 值类型 回返 `false` 当不是对象时 ```js assert.equal(isDescriptor('a'), false); assert.equal(isDescriptor(null), false); assert.equal(isDescriptor([]), false); ``` ### 数据描述符 回返 `true` 当对象具有有效值的有效属性时. ```js assert.equal(isDescriptor({ ...dataDefaults, value: 'foo' }), true); assert.equal(isDescriptor({ ...dataDefaults, value() {} }), true); ``` 回返 `false` 当对象具有无效属性时 ```js assert.equal(isDescriptor({ ...dataDefaults, value: 'foo', bar: 'baz' }), false); assert.equal(isDescriptor({ ...dataDefaults, value: 'foo', bar: 'baz' }), false); assert.equal(isDescriptor({ ...dataDefaults, value: 'foo', enumerable: 'baz' }), false); assert.equal(isDescriptor({ ...dataDefaults, value: 'foo', configurable: 'baz' }), false); assert.equal(isDescriptor({ ...dataDefaults, value: 'foo', get() {} }), false); assert.equal(isDescriptor({ ...dataDefaults, get() {}, value() {} }), false); ``` `false` 当一个值不是正确的类型时 ```js assert.equal(isDescriptor({ ...dataDefaults, value: 'foo', enumerable: 'foo' }), false); assert.equal(isDescriptor({ ...dataDefaults, value: 'foo', configurable: 'foo' }), false); assert.equal(isDescriptor({ ...dataDefaults, value: 'foo', writable: 'foo' }), false); ``` ### 访问者描述符 `true` 当对象具有有效值的有效属性时. ```js assert.equal(isDescriptor({ ...defaults, get() {}, set() {} }), true); assert.equal(isDescriptor({ ...defaults, get() {} }), true); assert.equal(isDescriptor({ ...defaults, set() {} }), true); ``` `false` 当对象具有无效属性时 ```js assert.equal(isDescriptor({ ...defaults, get() {}, set() {}, bar: 'baz' }), false); assert.equal(isDescriptor({ ...defaults, get() {}, set() {}, enumerable: 'baz' }), false); assert.equal(isDescriptor({ ...defaults, get() {}, writable: true }), false); assert.equal(isDescriptor({ ...defaults, get() {}, value: true }), false); ``` 回返 `false` 当访问器不是函数时 ```js assert.equal(isDescriptor({ ...defaults, get() {}, set: 'baz' }), false); assert.equal(isDescriptor({ ...defaults, get: 'foo', set() {} }), false); assert.equal(isDescriptor({ ...defaults, get: 'foo', bar: 'baz' }), false); assert.equal(isDescriptor({ ...defaults, get: 'foo', set: 'baz' }), false); ``` 回返 `false` 当一个值不是正确的类型时 ```js assert.equal(isDescriptor({ ...defaults, get() {}, set() {}, enumerable: 'foo' }), false); assert.equal(isDescriptor({ ...defaults, set() {}, configurable: 'foo' }), false); assert.equal(isDescriptor({ ...defaults, get() {}, configurable: 'foo' }), false); ``` ### 相关项目 您可能也对这些项目感兴趣: - [是访问者-描述符](https://www.npmjs.com/package/is-accessor-descriptor): 如果一个值具有有效的JavaScript访问器描述符的特性,则返回真值. - [is-data-描述符](https://www.npmjs.com/package/is-data-descriptor): 如果一个值具有有效的JavaScript数据描述符的特性,则返回真值. - [对象](https://www.npmjs.com/package/is-object): 如果值是对象而非数组或无效,则返回真值. ## 测试 仅仅复制回转, `npm install`运行 `npm test` ## 常见问题 ### is-descriptor 是什么？ 如果一个值具有有效的 JavaScript 描述符的特性, 返回 True 。 用于数据描述符和存取符描述符的工作\. ### 如何安装 is-descriptor？ 在项目目录运行 npm install is-descriptor，或使用 pnpm add / yarn add / bun add。 ### is-descriptor 支持 TypeScript 吗？ 该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/is-descriptor 是否存在。 ### is-descriptor 支持 ESM 还是 CommonJS？ 以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。 ### is-descriptor 需要什么版本的 Node\.js？ package\.json 的 engines 字段要求 Node\.js \>= 0\.4。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。 ### is-descriptor 可以商用吗？ is-descriptor 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。 ### is-descriptor 的下载量有多少？ 根据 npm 官方下载统计，is-descriptor 在 2026/10/05 – 2026/11/03 这 30 天内被下载 135,858,055 次，日均约 4,528,602 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。 ### is-descriptor 还在维护吗？ 最新版本 3\.1\.2 发布于 2026/05/11（5 个月前）；至今共发布 18 个版本，其中过去 12 个月发布了 3 个；首次发布于 2015/08/31。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。