@ 引用- js/ 插图- doi
用于引用.js的 DOI 输入插件 .
安装
npm install @citation-js/plugin-doi
使用量
通过导入软件包注册 :
require('@citation-js/plugin-doi')
“ Polite” API 访问
插件从 DOI 获取数据 DOI 内容谈判, (中文(简体) ),
这意味着Crossref、DataCite和mEDRA API被间接使用.
Crossref大力鼓励
添加一个 mailto: 链接到 User-Agent 页眉或 URL 参数
以获得更高的利率限制。 因为Crossref API只是间接使用,
uRL 参数方法不能一致使用。 此外 User-Agent
无法在浏览器中设置标题 。 但对于非浏览器用途,
用户代理可以这样设置 :
const { util, version } = require('@citation-js/core')
util.setUserAgent(`Example Foo (mailto:[email protected]) Citation.js/${version} Node.js/${process.versions.node}`)
此插件添加的格式和其他特性 .
支持以下列方式输入的 doIs :
@doi/api(单位:千美元) doi.org 網址@doi/id: 一个单一的DOI@doi/list+text: 白空分隔的 DIS 列表@doi/list+object: DOI 数组
此外,还暴露出下列内部类型:
@doi/type: 修补 type 某些API 响应中的值
关于 @citation-js/plugin-doi 的常见问题
@citation-js/plugin-doi 是什么？
引用.js 的 DOI 输入插件
如何安装 @citation-js/plugin-doi？
在项目目录运行 npm install @citation-js/plugin-doi，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@citation-js/core（^0.9.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。
@citation-js/plugin-doi 支持 TypeScript 吗？
支持。包内自带 TypeScript 类型声明（package.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。
@citation-js/plugin-doi 支持 ESM 还是 CommonJS？
同时提供 ES Module 与 CommonJS 入口，import 和 require() 都可以使用，打包工具会自动选择合适的版本。
@citation-js/plugin-doi 需要什么版本的 Node.js？
package.json 的 engines 字段要求 Node.js >=22.12.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。
@citation-js/plugin-doi 可以商用吗？
@citation-js/plugin-doi 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。
@citation-js/plugin-doi 的下载量有多少？
根据 npm 官方下载统计，@citation-js/plugin-doi 在 2026/10/10 – 2026/11/08 这 30 天内被下载 35,988 次，日均约 1,200 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。
@citation-js/plugin-doi 还在维护吗？
最新版本 0.9.0 发布于 2026/09/18（1 个月前）；至今共发布 54 个版本，其中过去 12 个月发布了 4 个；首次发布于 2018/12/07。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。