jsr - uki00a

jsr

#Deno #TypeScript #npm #sigstore #SLSA

JSRとは？

主にDeno向けに開発されたパッケージレジストリです

JSRはnpmレジストリと互換性があり、Deno以外にもNode.jsやBunなどの様々なランタイムからパッケージを利用できるのも特徴です

Deno本体にはjsrパッケージ向けのパッケージマネージャーが本体に組み込まれており、jsr:形式のURLを記述するとJSRからパッケージがダウンロードされます (Deno v2)

レジストリ(jsr.io)のソースコードはで公開されています

DenoにおけるJSRとの連携について

jsr: URL

DenoからJSRのパッケージをimportする際はjsr:形式のURLを指定します

例えば、以下のコードではdeno_stdのulidパッケージのv0.219.1を読み込んでいます (deno_stdはJSRの@stdスコープで公開されています)

code:typescript

import { ulid } from "jsr:@std/ulid@0.219.1";

JSRに公開されているパッケージについてはjsr.ioから探すことができます

deno publishコマンド

DenoからJSRにパッケージを公開するためのコマンドです

ドライラン(--dry-run)もサポートされています

deno addコマンド

JSRに公開されているパッケージをdeno.jsonのimports(Import maps)に追加してくれるコマンドです (npm installやyarn addなどに近いイメージです)

これにより、jsr:なしで該当のjsrパッケージを読み込めるようになります

例えば、以下はdeno addコマンドによりdaxパッケージを追加する例です

code:shell

# @david/daxパッケージをdeno.jsonのimportsに書き込む

$ deno add @david/dax

code:typescript

// jsr:なしで読み込むことができます

import $ from "@david/dax";

deno removeコマンド

指定されたパッケージをdeno.jsonから削除し、deno.lockを更新してくれます

code:shell

$ deno remove @david/dax

deno lintコマンド

jsrパッケージ向けにno-slow-typesなどのルールが用意されています (deno.jsonにname/version/exportsがあれば、自動で有効化されます)

deno.json

Denoの設定ファイルです

jsrに公開するパッケージのメタデータを定義できます (name/version/exports)

deno publishの実行時のみdeno.json/deno.jsoncに加えて、jsr.json/jsr.jsoncも探索されます

ワークスペース (Deno workspaces)

deno.jsonでワークスペースを定義することができます

deno_stdやfresh (Fresh v2以降)などで活用されています

fast check

jsrパッケージに関する型チェックを高速化するために導入されたDeno独自の仕組み (DenoにおけるTypeScriptの独自拡張について)

deno publishを実行する際などに実行されます

ブラウザーからJSRパッケージを使う

esm.shで実験的にサポートされているようです

code:javascript

import { toCamelCase } from "https://esm.sh/jsr/@std/text@0.218.2";

console.info(toCamelCase("DENO_DIR")); // => "denoDir"

esm.sh以外にも、後述のjsr-npmと各種バンドラーを併用して使用することも可能だと思います

Node.js/BunからJSRパッケージを使う

jsr-npmを使うことで、Node.jsやBunからJSRで公開されたパッケージを利用できます