Aller au contenu principal

Erreurs

ClasseQuand
LibreTranslateApiErrorUne réponse non-2xx
LibreTranslateConfigErrorConfiguration non valide : URL manquante ou mal formée
LibreTranslateTimeoutErrorAucune réponse timeoutMs

LibreTranslateApiError porte status, method, path (sans la chaîne de requête) et la réponse body. LibreTranslate répond aux erreurs comme { "error": "<message>" }, et ce message est celui de l'erreur.

ÉtatHabituellement
400Un paramètre manquant ou invalide, un fichier non pris en charge ou une clé est requis
403La clé API est invalide, ou le client est interdit
429Trop de demandes : attendez et réessayez
500La traduction a échoué sur l'instance
import { LibreTranslateApiError } from "@hoyasumii/libretranslate";

try {
await lt.translate({ q: "Olá", target: "en" });
} catch (error) {
if (error instanceof LibreTranslateApiError && error.status === 429) {
// back off and retry
} else throw error;
}

La clé API ne s'affiche jamais​

Chaque message d'erreur et body Passez par redact: les valeurs des clés telles que api_key devenir ***, ainsi que toute occurrence littérale de la propre clé du client, à l'intérieur des chaînes aussi. redact est exporté pour vos propres grumes:

import { redact } from "@hoyasumii/libretranslate";

console.log(redact(payload, [process.env.LIBRETRANSLATE_API_KEY!]));