roblox-testing

読み込むタイミング

ユニットテスト／統合テストの作成、Roblox サービスのモック、Lune を使った CI/CD の設定、または依存性注入によるテスト容易性を考慮したコードのリファクタリングを行うときに読み込みます。構文については roblox-luau-core、型設計については roblox-luau-types、アーキテクチャについては roblox-luau-patterns、検証については roblox-security に引き継いでください。

クイックリファレンス

TestEZ（BDD フレームワーク）

• インストール：wally.toml の [dev-dependencies] TestEZ = "roblox/[email protected]"
• ファイル：*.spec.luau、ソースと同じ場所に配置
• ブロック：describe → it → beforeEach/afterEach
• アサーション：expect(x).to.equal(y)、.to.be.near(n, ε)、.to.throw()

依存性注入

-- BAD: untestable outside Studio
local store = game:GetService("DataStoreService"):GetDataStore("PlayerData")
-- GOOD: inject dependency
local function saveData(player, data, dataStore)
    dataStore:SetAsync("player_" .. player.UserId, data)
end
-- Module init pattern:
function Manager.init(dataStoreService)
    _dss = dataStoreService or game:GetService("DataStoreService")
end

モックの基本

-- MockDataStore: in-memory Get/Set/Update
local M = {}
function M.new() return setmetatable({_data={}}, {__index=M}) end
function M:GetAsync(k) return self._data[k] end
function M:SetAsync(k,v) self._data[k]=v end
function M:GetDataStore() return self end
-- MockRemoteEvent: OnServerEvent + FireServer
-- MockSignal: Connect/Fire with Connected flag

Lune を使った CI/CD

# aftman.toml
[tools]
lune = "lune-org/[email protected]"

パイプライン：selene src/ → stylua --check src/ → luau-lsp analyze → lune run tests/run.luau

-- tests/run.luau
local TestEZ = require("@testez")
local results = TestEZ.TestBootstrap:run({game:GetService("ReplicatedStorage")}, TestEZ.Reporters.TextReporter)
if results.failureCount > 0 then os.exit(1) end

テストの優先順位

1. DataStore の保存／読み込みのラウンドトリップ（データ損失を防止）
2. マネタイズの ProcessReceipt（冪等性）
3. コア計算（ダメージ、バフ、経済）
4. サーバーの検証（リモートの悪用）

注意点

• 状態をリセットするには beforeEach を使用します。ロジック内で game:GetService() を呼び出してはいけません。
• テストは実行順に依存しないようにします。CI にはモックが必要です。wally.lock をコミットしてください。 詳細が必要ですか？ コード例、API テーブル、エッジケースを含む完全なリファレンスについては、references/full.md を読み込んでください。