Denoを対象に書かれたパッケージは、基本的にdeno.land/xやnest.landなどのレジストリで公開されることが多いです。

しかし、これらのレジストリに目当てのモジュールが見つからない場合もあるかと思います。

そのような場合は、npmパッケージの使用を検討してみるとよいかもしれません。

この章では、Denoからnpmパッケージを使用する方法について2つ紹介します。

• npm:URLを使用する
• npmパッケージを配布するCDNを利用する

npm:URLを使用する

Denoでパッケージをimportする際に、npm:<パッケージ名>@<バージョン>という形式のURLを指定すると、対象のパッケージをnpmレジストリから読み込んでくれます。

import chalk from "npm:chalk@5.0.1";
console.info(chalk.green("Hello, world!"));

実行する際は通常通り、deno runコマンドを利用できます。

$ deno run --allow-env --allow-read main.mjs

通常のサードパーティモジュールと同様に、初回実行時のみnpmレジストリからパッケージがダウンロードされ、以降はローカルにキャッシュされたパッケージが利用されます。

deno runの引数にnpm:形式のURLを指定することも可能で、Node.jsにおけるnpxコマンドのようにnpmパッケージで提供されるコマンドを直接実行することもできます。

$ deno run --unstable --allow-env --allow-read --allow-write npm:make-dir-cli@3.0.0 src/components

npm:URLでパッケージを読み込んだ際に、Node.jsの組み込みパッケージへの読み込みはdeno_std/nodeの読み込みに置き換えられます。

そのため、Node.jsのAPIに依存したパッケージもある程度動作させることができます。

npmパッケージを配布するCDNを利用する

Denoからnpmパッケージを利用する際の手段として、CDNから対象パッケージを直接importする方法があります。

esm.shやSkypackなどのCDNはX-TypeScript-Typesヘッダ^[1]をサポートするため、CDNから直接npmパッケージを読み込みたいときは、これらの利用を検討するとよいかと思います。

例えば、以下はesm.shからfast-xml-parserパッケージを読み込む例です。

import { XMLParser } from "https://esm.sh/fast-xml-parser@4.0.9";

const xmlDocument = await Deno.readTextFile("./test.xml");
const parser = new XMLParser();
const obj = parser.parse(xmlDocument);

// @deno-types="https://esm.sh/testdouble@3.16.1/index.d.ts"
export * as td from "https://esm.sh/testdouble@3.16.1/dist/testdouble.js";

どの方法を使うべき？

基本的には、npm:URLを使うのがよいかと思います。

Deno本体に組み込まれた機能であり、将来に渡って改善やメンテナンスが継続される可能性が高いと考えられるためです。

ただし、FreshやAleph.jsなどのようにesm.shの使用を想定したフレームワークも存在するため、esm.shの使い方についても把握しておくと便利な場合もあるかと思います。

いずれの方法を利用するにせよ、Import mapsなどで依存関係を管理しておくことで、いずれかの方法に素早く移行する余地が生まれるため、活用しておくとよいでしょう。

ポイント

• npm:URLを利用することで、npmレジストリから直接パッケージをimportすることができます。
• CDNからnpmパッケージを読み込む場合は、esm.shなどのX-TypeScript-TypesヘッダをサポートするCDNを利用すると便利です。