left

Construit un EitherLeft en associant une information métier obligatoire (string littérale) à une valeur représentant l'erreur. C'est la brique fondamentale pour signaler un échec contextualisé.

Exemple interactif

Syntaxe

function left<
	GenericInformation extends string, 
	const GenericInput extends unknown = undefined
>(
  information: GenericInformation,
  input?: GenericInput
): EitherLeft<GenericInformation, GenericInput>

Paramètres

• information : string littérale qui précise le type d'erreur (ex. "user.notFound").
• input : payload optionnel qui transporte les données utiles pour diagnostiquer le problème.

Valeur de retour

Un EitherLeft<Information, Value> que vous pouvez filtrer avec E.isLeft, E.hasInformation ou E.whenHasInformation.

Bonnes pratiques

• Utilisez des chaînes explicites ("auth.invalidToken", "order.paymentFailed").
• Réutilisez l'information comme clef de pattern matching pour déclencher la bonne réponse applicative.
• Retournez toujours un Either homogène (toutes les branches d'une fonction doivent renvoyer le même type d'Either).

Voir aussi

• right – Pendant côté succès.
• error – Alias spécialisé basé sur left("error", value).
• fail – Variante Left sans payload.