deno

Deno

リポジトリに deno.json／deno.jsonc が含まれている場合、deno.lock を使用している場合、またはスクリプトやドキュメントで deno task、deno run、deno test などが参照されている場合は、デフォルトのランタイム／ツールとして Deno を使用してください。

すぐに判断するためのルール

• リポジトリでタスクが定義されている場合は、deno task <name> を優先してください。
• 依存関係の管理には deno add／deno remove を使用してください（設定ファイルに書き込まれます）。
• deno run／deno test では、必要な権限を明示してください。

よく使う操作

新しいプロジェクトを初期化する

deno init

依存関係を追加する（JSR と npm）

# JSR (recommended for Deno-first packages)
deno add jsr:@std/path

# npm packages are supported too
deno add npm:react

# multiple at once
deno add jsr:@std/assert npm:chalk

依存関係を削除する

deno remove jsr:@std/path

スクリプトを実行する

# Minimal permissions: only what the program needs
# Examples:
#   --allow-net=api.example.com
#   --allow-read=./data
#   --allow-env=FOO,BAR

deno run --allow-net --allow-read main.ts

タスクを実行する

# list tasks
deno task

# run a task defined in deno.json/deno.jsonc
deno task dev

フォーマット、リント、テスト

deno fmt
deno lint
deno test

# common permissioned test run
deno test --allow-net --allow-read

CLI をインストール／実行する

# Run a JSR or npm package's CLI without installing globally
deno x jsr:@std/http/file-server -p 8080

# Install globally (requires choosing permissions at install time)
# Prefer the smallest set of permissions; avoid blanket flags unless necessary.
deno install -g -N -R jsr:@std/http/file-server -- -p 8080

注意点／落とし穴

• Deno はデフォルトでセキュリティが確保されています。権限が不足すると実行時エラーが発生するため、必要最小限の --allow-* フラグを追加してください。
• 依存関係の指定子：
  • JSR レジストリのパッケージには jsr:
  • npm パッケージには npm:
  • URL インポートもサポートされています（キャッシュされます）。
• ロックファイル：deno.lock により、依存関係の解決を再現可能にできます。