使用 JSR 与 Deno - 文档

Deno 是一个用于 JavaScript 和 TypeScript 的安全运行时。它使用导入映射或 jsr: 指定符对 JSR 导入提供原生支持。

使用导入映射

Deno 支持 Web 标准的导入映射，deno.json 配置文件可以通过 "imports" 字段充当导入映射。您可以手动将 JSR 导入添加到 deno.json 中，也可以使用 deno add 命令添加它们。

在本例中，我们将最新版本的 @luca/flag 添加到您的项目中。

deno add @luca/flag

执行此命令后，您将在 deno.json 中获得一个类似于以下内容的导入映射条目

{
  "imports": {
    "@luca/flag": "jsr:@luca/flag@^1.0.1"
  }
}

然后，您可以像这样从代码中使用该模块

import { printProgress } from "@luca/flag";
printProgress();

在 Deno 中，您可以使用 jsr: 说明符直接在源文件中使用包，而无需安装步骤。在本例中，我们直接在代码中导入 @luca/flag 模块，而无需导入映射条目。

import { printProgress } from "jsr:@luca/flag@^1.0.1";

printProgress();

Deno 提供了各种其他工具来帮助管理 JSR 包。

deno publish 命令可用于发布 JSR 包。包可以从本地机器或 CI 发布。

Deno 提供了一个内置的 lint 规则，以确保 JSR 包中所有导出的函数和变量都具有 JSDoc 注释。

可以使用 deno doc --lint 命令运行文档检查器。

deno doc --lint

Deno 还可以为您的包生成 HTML 版本的文档。这是一种很好的方式来预览包的文档在发布到 jsr.io 后会是什么样子。

deno doc --html

deno info 命令可用于分析 JSR 包的依赖关系。此命令将显示所有依赖关系的列表，包括它们的版本约束。

$ deno info jsr:@std/fs