コンテンツにスキップ
Omnio-js
Esc
↑↓移動↵開く⌘Jプレビュー
このページの内容

エラー

Omnio-js が公開する例外クラスと、発生条件のリファレンスです。

概要

Omnio-js のエラーはすべて ErrorBase を継承し、用途ごとに InvalidUsageErrorBase、UnexpectedErrorBase、DbErrorBase、EmbErrorBase の 4 つに分かれています。

@omniojs/core からエラークラスとメタデータの型をインポートできます。omnio は ChecksumMismatchError を再エクスポートします。

import {
  DbNotOpenError,
  EntityMissingError,
  InvalidOmnioKeyError,
  OperationAbortedError,
} from "@omniojs/core";
import { ChecksumMismatchError } from "omnio";

入力とキーのエラー

ValiError

valibot の検証エラーです。@omniojs/core ではなく valibot からインポートします。

コンストラクターや公開メソッドの入力がスキーマに合わないときに投げられます。error.issues に詳細が入ります。

InvalidOmnioKeyError

キーが空のとき、1024 文字か 1024 バイトを超えたとき、または正しい UTF-8 でないときに投げられます。

class InvalidOmnioKeyError extends InvalidUsageErrorBase<{
  input: unknown;
}> {}

name は OmnioInvalidKeyError です。

ライフサイクルのエラー

DbNotOpenError

open() の前や close() の後に操作すると投げられます。

class DbNotOpenError extends DbErrorBase<{
  operation: string;
}> {}

name は OmnioDbNotOpenError です。

OperationAbortedError

close() で実行中の操作を中断するときの理由として使います。

class OperationAbortedError extends ErrorBase<undefined> {}

name は OmnioOperationAbortedError です。

データのエラー

EntityMissingError

インデックスにレコードがあるのに、オブジェクトのバイト列が見つからない場合に投げられます。削除との競合ではなく、データ損失や不整合を示します。

class EntityMissingError extends UnexpectedErrorBase<{
  key: string;
  entityId: string;
  hash?: string;
}> {}

name は OmnioEntityMissingError です。

ChecksumMismatchError

取得したバイト列の SHA-256 がインデックスに記録されたハッシュと一致しない場合に投げられます。@unikvs/checksum のエラーで、omnio から再エクスポートされています。

DbQueryError

インデックスのデータベース操作に失敗した場合に投げられます。

class DbQueryError extends DbErrorBase<{
  operation: string;
  queryText?: string;
}> {}

name は OmnioDbQueryError です。

VectorDimensionMismatchError

ベクトルの次元数が保存先の定義と一致しない場合に投げられます。

class VectorDimensionMismatchError extends DbErrorBase<{
  actual: number;
  expected: number;
}> {}

name は OmnioVectorDimensionMismatchError です。

EmbeddingModelMismatchError

埋め込みモデル名が期待されるものと一致しない場合に使うエラーです。通常の SQL インデックスでは使いませんが、独自のインデックス実装で利用できます。

class EmbeddingModelMismatchError extends DbErrorBase<{
  actual?: string;
  expected: string;
}> {}

name は OmnioEmbeddingModelMismatchError です。

埋め込みのエラー

ModelLoadError

埋め込みモデルの読み込みに失敗した場合に投げられます。

class ModelLoadError extends EmbErrorBase<{
  model: string;
}> {}

name は OmnioModelLoadError です。

EmbedFailedError

テキストや画像の埋め込みに失敗したときに投げられます。

class EmbedFailedError extends EmbErrorBase<{
  kind: string;
}> {}

name は OmnioEmbedFailedError です。

UnsupportedModalityError

埋め込み器が対応していないモダリティーを要求したときに投げられます。

class UnsupportedModalityError extends EmbErrorBase<{
  actual: string;
  supported: readonly string[];
}> {}

name は OmnioUnsupportedModalityError です。

エラーの基底クラス

クラス 用途
ErrorBase すべてのエラーの基底です。
InvalidUsageErrorBase 不正な使い方を示します。
UnexpectedErrorBase 予期しない失敗を示します。
DbErrorBase インデックスとデータベースのエラーです。
EmbErrorBase 埋め込みのエラーです。

メッセージのカスタマイズ

setErrorMessage を使うと、言語ごとにメッセージを設定できます。

import { setErrorMessage, DbQueryError } from "@omniojs/core";

setErrorMessage(DbQueryError, ({ operation }) => `DB エラー: ${operation}`, "ja");

次に読む

このページは役に立ちましたか?