Fehlerbehandlung
Stabile Fehlercodes der nativen Capacitor-Fehler und der Web-Implementierung. Zugehörige Anleitungen: Chat, Verfügbarkeit, Bilder, Migration.
Native Capacitor-Fehler und die Web-Implementierung stellen einen stabilen String code bereit, der LocalLLMErrorCode entspricht. Im Web wird bei Fehlern eine LocalLLMException ausgelöst, die Error erweitert und code setzt.
import { LocalLLM, LocalLLMException } from '@rdlabo/capacitor-local-llm';
try {
await LocalLLM.generateText({ chatId: 'missing', prompt: 'Hello' });
} catch (err) {
const code = err instanceof LocalLLMException ? err.code : (err as { code?: string }).code;
console.log(code, (err as Error).message);
}
LocalLLMErrorCode
| Code | Beschreibung |
|---|---|
LOCAL_LLM_NOT_AVAILABLE |
Das On-Device-Textmodell ist nicht verfügbar. |
LOCAL_LLM_DEVICE_NOT_ELIGIBLE |
Das Gerät oder Betriebssystem unterstützt keine On-Device-Textgenerierung. |
LOCAL_LLM_NOT_ENABLED |
On-Device-KI wird unterstützt, wurde vom Benutzer jedoch nicht aktiviert. |
LOCAL_LLM_MODEL_NOT_READY |
Das Modell wird heruntergeladen oder initialisiert (downloading / not-ready). |
LOCAL_LLM_MODEL_DOWNLOAD_REQUIRED |
Das Modell muss zunächst heruntergeladen werden (downloadable). |
LOCAL_LLM_CONTEXT_WINDOW_EXCEEDED |
Die Eingabe und die angeforderte Ausgabe passen auch nach dem Kürzen entfernbarer Verlaufseinträge nicht in den verfügbaren Kontext. |
LOCAL_LLM_CHAT_NOT_FOUND |
Die chatId existiert nicht. |
LOCAL_LLM_CHAT_BUSY |
Für diesen Chat läuft bereits eine Generierung. |
LOCAL_LLM_GENERATION_NOT_FOUND |
Es gibt keine passende laufende Generierung, oder die generationId stimmt nicht überein. |
LOCAL_LLM_GENERATION_CANCELLED |
Die Generierung wurde über cancelGeneration() oder deleteChat() abgebrochen. |
LOCAL_LLM_INVALID_OPTIONS |
Ein Optionswert fehlt oder liegt außerhalb des zulässigen Bereichs. |
LOCAL_LLM_UNSUPPORTED |
Die Methode oder Funktion wird auf dieser Plattform oder Betriebssystemversion nicht unterstützt. |
LOCAL_LLM_IMAGE_NOT_READABLE |
Ein Bild-URI kann nicht aufgelöst, geöffnet oder dekodiert werden. |
LOCAL_LLM_IMAGE_TOO_LARGE |
Ein Bild überschreitet die Eingabegrößenbeschränkung der Plattform. |
LOCAL_LLM_GENERATION_FAILED |
Die Generierung ist aus einem stabilen, plattformspezifisch zugeordneten Grund fehlgeschlagen. |
LOCAL_LLM_IMAGE_GENERATION_FAILED |
Die Bildgenerierung ist fehlgeschlagen, etwa weil kein Stil verfügbar ist. |
LOCAL_LLM_UNKNOWN_ERROR |
Ein unerwarteter Fehler des zugrunde liegenden SDK ist aufgetreten. Einzelheiten finden Sie in message. |