エラー

エラー

カテゴリ分けとリトライメタデータ付きの構造化エラー処理。グローバルerrorsテーブルはrequireなしで利用可能。

エラーの作成

-- シンプルなメッセージ（kindはデフォルトでUNKNOWN）
local err = errors.new("something went wrong")

-- kind、retryable、details付き
local err = errors.new({
    message = "user not found",
    kind = errors.NOT_FOUND,
    retryable = false,
    details = {user_id = 123}
})

errors.newは文字列メッセージか、少なくともmessageフィールドを持つテーブルを受け付けます。(kind, message)形式はサポートされていません。

エラーのラップ

kind、retryable、detailsを保持しながらコンテキストを追加：

local data, err = db.query("SELECT * FROM users")
if err then
    return nil, errors.wrap(err, "failed to load users")
end

エラーメソッド

メソッド	戻り値	説明
err:kind()	string	エラーカテゴリ
err:message()	string	エラーメッセージ
err:retryable()	boolean/nil	操作を再試行できるかどうか
err:details()	table/nil	構造化メタデータ
err:stack()	string	Luaスタックトレース
tostring(err)	string	完全な表現

Kindのチェック

if errors.is(err, errors.INVALID) then
    -- 無効な入力を処理
end

-- または直接比較
if err:kind() == errors.NOT_FOUND then
    -- 見つからないリソースを処理
end

エラー種別

定数	ユースケース
errors.NOT_FOUND	リソースが存在しない
errors.ALREADY_EXISTS	リソースが既に存在
errors.INVALID	不正な入力または引数
errors.PERMISSION_DENIED	アクセス拒否
errors.UNAVAILABLE	サービスが一時的にダウン
errors.INTERNAL	内部エラー
errors.CANCELED	操作がキャンセルされた
errors.CONFLICT	リソース状態のコンフリクト
errors.TIMEOUT	操作がタイムアウト
errors.RATE_LIMITED	リクエストが多すぎる
errors.UNKNOWN	未指定のエラー

コールスタック

構造化されたコールスタックを取得：

local stack = errors.call_stack(err)
if stack then
    print("Thread:", stack.thread)
    for _, frame in ipairs(stack.frames) do
        print(frame.source .. ":" .. frame.line, frame.name)
    end
end

再試行可能なエラー

通常再試行可能	再試行不可
TIMEOUT	INVALID
UNAVAILABLE	NOT_FOUND
RATE_LIMITED	PERMISSION_DENIED
	ALREADY_EXISTS

if err:retryable() then
    -- 安全に再試行
end

エラー詳細

local err = errors.new({
    message = "validation failed",
    kind = errors.INVALID,
    details = {
        errors = {
            {field = "email", message = "invalid format"},
            {field = "age", message = "must be positive"}
        }
    }
})

local details = err:details()
for _, e in ipairs(details.errors) do
    print(e.field, e.message)
end