# @digitalcredentials/credentials-v2-context 中文文档

规范地址：https://npmcn.com/package/%40digitalcredentials/credentials-v2-context/

版本：1\.0\.0
npm 元数据更新时间：2026-09-30T17:46:12.021Z
中文译文更新时间：2026-11-12T08:52:22.441Z
软件包许可：BSD-3-Clause

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

原始 npm 页面：https://www.npmjs.com/package/%40digitalcredentials/credentials-v2-context
原文对照：https://npmcn.com/package/%40digitalcredentials/credentials-v2-context/?lang=original
项目主页：https://github.com/digitalcredentials/credentials-v2-context#readme
源码仓库：https://github.com/digitalcredentials/credentials-v2-context

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

- 包体积（解压后）：35.7 kB，8 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：未声明
- Node.js 要求：\>=18
- 运行依赖：0 个
- 首次发布：2024-07-18T22:03:24.078Z
- 最新版本发布：2025-05-21T20:25:58.159Z
- 近 30 天下载量：58962（2026-10-12 至 2026-11-10，npm 官方下载统计）
- 已发布版本数：2（近 12 个月 0 个）

## 中文简介

用于JavaScript的可验证身份验证数据模型 2.0上下文库.

## 安装

```sh
npm install @digitalcredentials/credentials-v2-context
```

也可以使用：`pnpm add @digitalcredentials/credentials-v2-context`、`yarn add @digitalcredentials/credentials-v2-context`、`bun add @digitalcredentials/credentials-v2-context`

## README

# JavaScript 可验证的地物数据模型 2.0 背景 _(@digitalbazaar/证书-v2-context) (中文(简体) )_

[![Build Status](https://img.shields.io/github/actions/workflow/status/digitalbazaar/credentials-v2-context/main.yaml)](https://github.com/digitalbazaar/credentials-v2-context/actions/workflow/main.yaml) [![NPM Version](https://img.shields.io/npm/v/@digitalbazaar/credentials-v2-context.svg)](https://npm.im/@digitalbazaar/credentials-v2-context)

> 用于JavaScript的可验证身份验证数据模型 2.0上下文库.

## 目录

-   [背景情况](https://npmcn.com/package/%40digitalcredentials/credentials-v2-context/#readme-background)
-   [安装](https://npmcn.com/package/%40digitalcredentials/credentials-v2-context/#readme-install)
-   [使用量](https://npmcn.com/package/%40digitalcredentials/credentials-v2-context/#readme-usage)
-   [API 密码](https://npmcn.com/package/%40digitalcredentials/credentials-v2-context/#readme-api)
-   [状态](https://npmcn.com/package/%40digitalcredentials/credentials-v2-context/#readme-status)
-   [发展中国家](https://npmcn.com/package/%40digitalcredentials/credentials-v2-context/#readme-developing)
-   [商业支助](https://npmcn.com/package/%40digitalcredentials/credentials-v2-context/#readme-commercial-support)
-   [许可证](https://npmcn.com/package/%40digitalcredentials/credentials-v2-context/#readme-license)

## 背景情况

另见(相关规格):

-   [可验证的证书数据模型 2.0](https://w3c.github.io/vc-data-model)

## 安装

-   要求节点18+

通过国家预防机制安装:

```
npm install @digitalbazaar/credentials-v2-context
```

## 使用量

```js
// ESM
import {
  CONTEXT,
  CONTEXT_URL,
  constants,
  context
} from '@digitalbazaar/credentials-v2-context';

// CommonJS
const ctx = require('@digitalbazaar/credentials-v2-context');
const {
  CONTEXT,
  CONTEXT_URL,
  constants,
  context
} = ctx;

// Default context URL
CONTEXT_URL
// -> 'https://www.w3.org/ns/credentials/v2'

// Default context data
CONTEXT
// -> full context object

// Codec term map value for CBOR-LD
constants.CBORLD_VALUE
// -> 0x0

// get context data for a specific context
const data = contexts.get('https://www.w3.org/ns/credentials/v2');
```

此软件包可用于捆绑器, 例如 [网络软件包](https://webpack.js.org/)浏览器 应用.

## API 密码

库输出以下属性:

-   `CONTEXT_URL`: 默认上下文 URL.
-   `CONTEXT`: 默认上下文数据.
-   `CBORLD_VALUE`: 默认编码术语地图值 [边界](https://digitalbazaar.github.io/cbor-ld-spec/)。 。 。 .
-   `constants`: 一个将常数映射到知名上下文 URL 的对象. 这个 主常数 `CONTEXT_URL` 可不时更新至 最新上下文位置.
-   `contexts`页:1 `Map` 将所有上下文 URL 映射到完整上下文数据.
-   `appContextMap`: 与 [圆形](https://github.com/digitalbazaar/cborld) 图书馆.

## 状态

-   `https://www.w3.org/ns/credentials/v2`: 正在开发中。 不稳定.

## 发展中国家

资料来源:

-   [https://github.com/digitalbazaar/credititives-v2-context 互联网档案馆的存檔,存档日期2013-12-2](https://github.com/digitalbazaar/credentials-v2-context)

**警告**编号: `.jsonld` 内 `contexts/` 是自动生成的,由 `npm run build` 脚本, 每次你运行测试套房.

不要直接编辑它(或您的修改会被快速覆盖) . 相反,将所有上下文更改为 `js/context.js`。 。 。 .

## 商业支助

该图书馆的商务支助可应下列请求提供: 数字集市: [支持@ digitalbazaar.com](mailto:support@digitalbazaar.com)

## 许可证

-   BSD 3- Clause 数字集市
-   见 [自由主义](https://npmcn.com/package/%40digitalcredentials/credentials-v2-context/LICENSE) 详细文件.

## 常见问题

### @digitalcredentials/credentials-v2-context 是什么？

用于JavaScript的可验证身份验证数据模型 2\.0上下文库\.

### 如何安装 @digitalcredentials/credentials-v2-context？

在项目目录运行 npm install @digitalcredentials/credentials-v2-context，或使用 pnpm add / yarn add / bun add。

### @digitalcredentials/credentials-v2-context 支持 TypeScript 吗？

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

### @digitalcredentials/credentials-v2-context 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @digitalcredentials/credentials-v2-context 需要什么版本的 Node\.js？

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

### @digitalcredentials/credentials-v2-context 可以商用吗？

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

### @digitalcredentials/credentials-v2-context 的下载量有多少？

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

### @digitalcredentials/credentials-v2-context 还在维护吗？

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