Deno

Deno は V8 上に構築された JavaScript ランタイムです。 Node.js ではありません。 Hono は Deno でも動作します。

Hono を使用して TypeScript でコードを書き、 deno コマンドでアプリケーションを起動します。 そして "Deno Deploy" にデプロイ出来ます。

1. Deno のインストール

まず deno コマンドをインストールします。 公式ドキュメント を参照してください。

2. セットアップ

Deno でもスターターを使用できます。 "create-hono" コマンドでプロジェクトを作成してください。

deno init --npm hono my-app

Select deno template for this example.

my-app に移動しますが、 Deno では Hono を明示的にインストールする必要はありません。

cd my-app

3. Hello World

最初のアプリケーションを書いていきましょう。

import { Hono } from 'hono'

const app = new Hono()

app.get('/', (c) => c.text('Hello Deno!'))

Deno.serve(app.fetch)

4. Run

このコマンドだけです:

deno task start

ポートを変える

main.ts の Deno.serve の引数を変更することでポート番号を指定できます:

Deno.serve(app.fetch) 
Deno.serve({ port: 8787 }, app.fetch) 

静的ファイルの提供

静的ファイルを提供するには hono/middleware.ts から serveStatic をインポートして使用します。

import { Hono } from 'hono'
import { serveStatic } from 'hono/deno'

const app = new Hono()

app.use('/static/*', serveStatic({ root: './' }))
app.use('/favicon.ico', serveStatic({ path: './favicon.ico' }))
app.get('/', (c) => c.text('You can access: /static/hello.txt'))
app.get('*', serveStatic({ path: './static/fallback.txt' }))

Deno.serve(app.fetch)

上のコードは、このようなディレクトリ構成で機能します。

./
├── favicon.ico
├── index.ts
└── static
    ├── demo
    │   └── index.html
    ├── fallback.txt
    ├── hello.txt
    └── images
        └── dinotocat.png

rewriteRequestPath

http://localhost:8000/static/* を ./statics にマップしたい場合、 rewriteRequestPath をオプションに追加してください:

app.get(
  '/static/*',
  serveStatic({
    root: './',
    rewriteRequestPath: (path) =>
      path.replace(/^\/static/, '/statics'),
  })
)

mimes

MIME タイプを追加するためには mimes を使用します:

app.get(
  '/static/*',
  serveStatic({
    mimes: {
      m3u8: 'application/vnd.apple.mpegurl',
      ts: 'video/mp2t',
    },
  })
)

onFound

要求されたファイルが見つかったときの処理を onFound で指定できます:

app.get(
  '/static/*',
  serveStatic({
    // ...
    onFound: (_path, c) => {
      c.header('Cache-Control', `public, immutable, max-age=31536000`)
    },
  })
)

onNotFound

onNotFound を使用して、要求されたファイルが見つからない場合の処理を記述できます:

app.get(
  '/static/*',
  serveStatic({
    onNotFound: (path, c) => {
      console.log(`${path} is not found, you access ${c.req.path}`)
    },
  })
)

precompressed

precompressed オプションを使うと Accept-Encoding ヘッダに基づいて .br や .gz といった拡張子を持っているファイルが有るか確認し、提供します。 Brotli 、 Zstd 、 Gzip の順で優先されます。 それらが無ければ元のファイルが提供されます。

app.get(
  '/static/*',
  serveStatic({
    precompressed: true,
  })
)

Deno Deploy

Deno Deploy は Deno のためのエッジランタイムプラットフォームです。 Deno Deploy でワールドワイドにアプリケーションを公開できます。

Hono は Deno Deploy もサポートしています。 公式ドキュメントを参照してください。

テスト

Deno でアプリケーションをテストするのは簡単です。 Deno.test と、公式ライブラリの assert か assertEquals を @std/assert からインポートして書いてください。

deno add jsr:@std/assert

import { Hono } from 'hono'
import { assertEquals } from '@std/assert'

Deno.test('Hello World', async () => {
  const app = new Hono()
  app.get('/', (c) => c.text('Please test me'))

  const res = await app.request('http://localhost/')
  assertEquals(res.status, 200)
})

次にこのコマンドを実行します:

deno test hello.ts

npm: 指定子

npm:hono も使えます。 これを使うためには deno.json を修正します:

{
  "imports": {
    "hono": "jsr:@hono/hono"
    "hono": "npm:hono"
  }
}

npm:hono か jsr:@hono/hono のどちらかを使うことができます。

npm:@hono/zod-validator といったサードパーティミドルウェアを TypeScript の型推論付きで使用したい場合は、 npm: 指定子が必要です。

{
  "imports": {
    "hono": "npm:hono",
    "zod": "npm:zod",
    "@hono/zod-validator": "npm:@hono/zod-validator"
  }
}