# pathval 中文文档

规范地址：https://npmcn.com/package/pathval/

版本：2\.0\.1
npm 元数据更新时间：2025-06-25T08:27:11.064Z
中文译文更新时间：2026-11-05T16:22:17.712Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/pathval
原文对照：https://npmcn.com/package/pathval/?lang=original
项目主页：https://github.com/chaijs/pathval
源码仓库：https://github.com/chaijs/pathval

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

- 包体积（解压后）：14.3 kB，4 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>= 14\.16
- 运行依赖：0 个
- 首次发布：2013-11-24T18:10:05.614Z
- 最新版本发布：2025-06-25T08:27:10.669Z
- 近 30 天下载量：218707966（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：10（近 12 个月 0 个）

## 中文简介

给定字符串路径的对象值检索

## 安装

```sh
npm install pathval
```

也可以使用：`pnpm add pathval`、`yarn add pathval`、`bun add pathval`

## README

# [![ChaiJS](http://chaijs.com/img/chai-logo.png)](http://chaijs.com/ "Chai Documentation")  
路径val

对象值检索工具给定字符串路径 [节点](http://nodejs.org/) 和浏览器.

 [![license:mit](https://img.shields.io/badge/license-mit-green.svg?style=flat-square)](https://npmcn.com/package/pathval/LICENSE)[![tag:?](https://img.shields.io/github/tag/chaijs/pathval.svg?style=flat-square) ](https://github.com/chaijs/pathval/releases)[![build:?](https://img.shields.io/travis/chaijs/pathval/master.svg?style=flat-square) ](https://travis-ci.org/chaijs/pathval)[![coverage:?](https://img.shields.io/coveralls/chaijs/pathval/master.svg?style=flat-square) ](https://coveralls.io/r/chaijs/pathval)[![npm:?](https://img.shields.io/npm/v/pathval.svg?style=flat-square) ](https://www.npmjs.com/packages/pathval)[![dependencies:?](https://img.shields.io/npm/dm/pathval.svg?style=flat-square) ](https://www.npmjs.com/packages/pathval)![devDependencies:?](https://img.shields.io/david/chaijs/pathval.svg?style=flat-square)  
[![Selenium Test Status](https://saucelabs.com/browser-matrix/chaijs-pathval.svg)](https://saucelabs.com/u/chaijs-pathval)  
 [![Join the Slack chat](https://img.shields.io/badge/slack-join%20chat-E2206F.svg?style=flat-square)](https://chai-slack.herokuapp.com/)[![Join the Gitter chat](https://img.shields.io/badge/gitter-join%20chat-D0104D.svg?style=flat-square)](https://gitter.im/chaijs/chai)

## 什么是路径val?

Pathval 是用于获取或设定对象属性的模块 `String` 路径.

## 安装

### 节点.js

`pathval` 可在 [无](http://npmjs.org/)。要安装,请输入:

```
$ npm install pathval
```

### 浏览器

您也可以在浏览器内使用;通过 npm 安装并使用 `pathval.js` 在下载中找到文件。 例如:

```html
<script src="./node_modules/pathval/pathval.js"></script>
```

## 使用量

二. 主要出口 `pathval` 是具有下列方法的对象:

-   `hasProperty(object, name)` - 检查是否 `object` 已经 `name`d 属性或数字数组索引.
-   `getPathInfo(object, path)` - 返回信息显示值的对象 `parent` 该路径 `name` 及其财产的回收 `value`。 。 。 .
-   `getPathValue(object, path)` - 获取特定财产的价值 `path` 在一个 `object`' '.
-   `setPathValue(object, path, value)` - 设定 `value` 特定财产 `path` 在一个 `object` ,并返回属性设定的对象.

```js
var pathval = require('pathval');
```

#### Property(对象,名称)

```js
var pathval = require('pathval');

var obj = { prop: 'a value' };
pathval.hasProperty(obj, 'prop'); // true
```

#### .getPathInfo(对象,路径)

```js
var pathval = require('pathval');

var obj = { earth: { country: 'Brazil' } };
pathval.getPathInfo(obj, 'earth.country'); // { parent: { country: 'Brazil'  }, name: 'country', value: 'Brazil', exists: true }
```

#### .getPathValue(对象,路径)

```js
var pathval = require('pathval');

var obj = { earth: { country: 'Brazil' } };
pathval.getPathValue(obj, 'earth.country'); // 'Brazil'
```

#### .setPathValue(对象、路径、值)

```js
var pathval = require('pathval');

var obj = { earth: { country: 'Brazil' } };
pathval.setPathValue(obj, 'earth.country', 'USA');

obj.earth.country; // 'USA'
```

## 常见问题

### pathval 是什么？

给定字符串路径的对象值检索

### 如何安装 pathval？

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

### pathval 支持 TypeScript 吗？

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

### pathval 支持 ESM 还是 CommonJS？

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

### pathval 需要什么版本的 Node\.js？

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

### pathval 可以商用吗？

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

### pathval 的下载量有多少？

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

### pathval 还在维护吗？

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