Durable Objects、Workers — 新しい cloudflare:test ヘルパーで Durable Object の追い出し（eviction）をテスト

概要

@cloudflare/vitest-pool-workers パッケージに evictDurableObject と evictAllDurableObjects のテスト用ヘルパーが追加され、cloudflare:test からエクスポートされるようになりました。これらのヘルパーを使うことで、アイドル状態の Durable Object がメモリから追い出されるという本番環境のライフサイクルをシミュレートし、追い出し後の挙動をテストできます。詳しい背景は "Lifecycle of a Durable Object" を参照してください。

使用例（TypeScript）

以下は cloudflare:test のヘルパーを使ったサンプルです。

import { evictDurableObject , evictAllDurableObjects } from "cloudflare:test" ;
import { env } from "cloudflare:workers" ;
const id = env . COUNTER . idFromName ( "my-counter" ) ;
const stub = env . COUNTER . get ( id ) ;
// Evict the Durable Object instance pointed to by a specific stub
await evictDurableObject ( stub ) ;
// Close WebSockets instead of hibernating them
await evictDurableObject ( stub , { webSockets : "close" } ) ;
// Evict all currently-running Durable Objects in evictable namespaces
await evictAllDurableObjects () ;

• evictDurableObject(stub)：特定の stub が指す Durable Object インスタンスを追い出します。
• evictDurableObject(stub, { webSockets: "close" })：WebSocket をハイバーネートせずにクローズします。
• evictAllDurableObjects()：追い出し可能なネームスペースで現在実行中のすべての Durable Object を追い出します。

利用可能なバージョン

これらのヘルパーは @cloudflare/vitest-pool-workers@0.16.20 以降で利用可能です。

詳細・参照

• Test APIs reference
• Testing Durable Objects guide
• Lifecycle of a Durable Object

（上記ドキュメント名を参照して、実践的なテスト方法や追加オプションを確認してください。）