jest

Jest Roblox v3.x を基に作成。生成日：2026-02-07。

Jest Roblox は、Roblox プラットフォーム向けの Jest の Luau 移植版です。上流の Jest API に忠実に従っていますが、Luau 言語の制約により、重大な相違点があります。

JS Jest との重大な相違点：

• 予約語のため、.not ではなく .never を使用します
• jest.fn() は2つの値（モックオブジェクトと転送関数）を返します
• Luau では 0、""、{} は真値です（偽値は false と nil のみです）
• すべてのグローバル（describe、expect、jest など）は明示的にインポートする必要があります
• .each はタグ付きテンプレートリテラルではなく、テーブル構文を使用します
• カスタムマッチャーは、最初のパラメーターとして self を受け取ります

このコードベースで作業する際は、まず core-deviations をお読みください。

コアリファレンス

トピック	説明	リファレンス
相違点	JS Jest との Luau／Roblox におけるすべての相違点	core-deviations
テスト構成	describe、test／it、フック、.each、.only／.skip	core-test-structure
マッチャー	toBe、toEqual、toContain、toThrow、モックマッチャー	core-matchers
非対称マッチャー	expect.anything／any／nothing／callable、.resolves／.rejects	core-asymmetric-matchers
モック	jest.fn()、spyOn、mock.calls、戻り値	core-mocking
設定	jest.config.lua、runCLI、レポーター、オプション	core-configuration

機能

テストパターン

トピック	説明	リファレンス
非同期テスト	Promise、done コールバック、.resolves／.rejects	feature-async-testing
カスタムマッチャー	expect.extend()、self パラメーター、isNever	feature-custom-matchers
スナップショットテスト	toMatchSnapshot、プロパティマッチャー、シリアライザー	feature-snapshot-testing
テストのフィルタリング	testMatch、testPathPattern、testNamePattern	feature-test-filtering

モック

トピック	説明	リファレンス
タイマーモック	useFakeTimers、Roblox タイマー、engineFrameTime	feature-timer-mocks
グローバルモック	jest.globalEnv、グローバルの spyOn、ライブラリのモック	feature-global-mocks
モジュールのモック	jest.mock()、isolateModules、resetModules	feature-module-mocking

拡張マッチャー

トピック	説明	リファレンス
Jest Extended	コアマッチャーでは表現力が足りない場合に使用します。厳密な真偽値、範囲、メンバーシップ、エントリー、呼び出し順、副作用に対応します	feature-jest-extended

高度な機能

トピック	説明	リファレンス
ベンチマーク	benchmark()、Reporter、Profiler、CustomReporters	advanced-benchmarking