Analyse défensive et enveloppes d’erreur
Construisez une gestion robuste des requêtes : analysez-les de manière défensive, associez toutes les défaillances à une enveloppe d’erreur JSON compacte et évitez de divulguer les éléments internes.
Analyse défensive et enveloppes d’erreur est une leçon TypeScript Academy gratuite sur CoddyKit. Ceci est la leçon 2 sur 2. Tu peux lire la leçon complète ci-dessous gratuitement — puis la pratiquer en direct dans le navigateur avec un éditeur de code intégré et un tuteur IA 24/7. Elle fait partie du parcours d'apprentissage TypeScript Academy, et ta progression se synchronise sur le web et l'application CoddyKit. Le cours TypeScript Academy comprend 2 leçons au total.
Introduction
Objectif : analyser les entrées de manière défensive et toujours renvoyer une enveloppe d’erreur JSON prévisible. Nous garderons la validation près de la frontière, standardiserons les échecs et conserverons des journaux détaillés tandis que les réponses resteront minimales.
- safeParse sur toutes les entrées non fiables
- { error, code, details? } cohérent
- Discipline entre 4xx et 5xx
Convertisseur d’enveloppe
Définissez une petite ErrorEnvelope réutilisable. Convertissez les erreurs unknown en cette enveloppe sans exposer les traces d’exécution.
export type ErrorEnvelope = { error: string; code?: string; details?: unknown }
export function toEnvelope(u: unknown): ErrorEnvelope {
if (u instanceof Error) return { error: u.message }
if (typeof u === "string") return { error: u }
try { return { error: JSON.stringify(u) } } catch { return { error: "Unknown error" } }
}Fonction utilitaire de validation
Enveloppez les schémas dans une fonction utilitaire validate qui renvoie un résultat discriminé. Les gestionnaires restent petits et cohérents.
import { z, type ZodTypeAny } from "zod"
export function validate<T extends ZodTypeAny>(schema: T, value: unknown) {
const r = schema.safeParse(value)
if (!r.success) {
return { ok: false as const, issues: r.error.format() }
}
return { ok: true as const, data: r.data as z.infer<T> }
}Gestionnaire défensif
Validez tôt ; renvoyez 400 avec les détails des problèmes. Les échecs inattendus se propagent vers l’intergiciel de gestion des erreurs sous la forme d’une 500 accompagnée de l’enveloppe.
import type { Request, Response, NextFunction } from "express"
import { z } from "zod"
import { validate } from "./validate"
import { toEnvelope, type ErrorEnvelope } from "./envelope"
const bodySchema = z.object({ email: z.string().email(), newsletter: z.boolean().default(false) })
export function subscribe(req: Request, res: Response<{ ok: true } | ErrorEnvelope>, next: NextFunction) {
const r = validate(bodySchema, req.body)
if (!r.ok) return res.status(400).json({ error: "Invalid body", details: r.issues })
try {
// pretend to persist
return res.status(201).json({ ok: true })
} catch (e) {
return next(e)
}
}
export function errorMiddleware(err: unknown, _req: Request, res: Response<ErrorEnvelope>, _next: NextFunction) {
const env = toEnvelope(err)
res.status(500).json(env)
}Enveloppes courantes
Fournissez de petites fonctions utilitaires pour les résultats courants : 404/401 avec des chaînes code stables afin que les clients puissent choisir leur traitement de manière fiable.
export function notFound(resource: string): { status: 404; body: { error: string; code: string } } {
return { status: 404, body: { error: `${resource} not found`, code: "NOT_FOUND" } }
}
export function unauthorized(): { status: 401; body: { error: string; code: string } } {
return { status: 401, body: { error: "unauthorized", code: "UNAUTHORIZED" } }
}Journaux et réponse
Équilibrez les journaux et la réponse : consignez l’erreur complète côté serveur (trace, identifiant de requête, identifiant utilisateur), mais renvoyez une enveloppe minimale au client. Envisagez des limites de débit et la suppression des données sensibles pour les PII.
Vérification de la pratique des enveloppes
Vérification rapide : comment les erreurs de validation doivent-elles être renvoyées ?
Récapitulatif
Récapitulatif : validez les entrées avec safeParse, convertissez les échecs en une enveloppe compacte et séparez les journaux détaillés des réponses minimales destinées au client.
Questions Fréquemment Posées
La leçon « Analyse défensive et enveloppes d’erreur » est-elle gratuite ?
Oui — le texte complet de « Analyse défensive et enveloppes d’erreur » est gratuit à lire ici sur le web. Pour la pratiquer de manière interactive (un éditeur de code intégré et un tuteur IA 24/7) et déverrouiller le reste du cours TypeScript Academy, passe à CoddyKit PRO. Le cours TypeScript Academy comprend 2 leçons au total.
Qu'est-ce que j'apprendrai dans « Analyse défensive et enveloppes d’erreur » ?
Construisez une gestion robuste des requêtes : analysez-les de manière défensive, associez toutes les défaillances à une enveloppe d’erreur JSON compacte et évitez de divulguer les éléments internes. Tu pratiques TypeScript Academy avec du code pratique que tu exécutes directement dans le navigateur, et un tuteur IA 24/7 répond à tes questions au fur et à mesure que tu avances dans la leçon.
Dois-je avoir de l'expérience pour commencer TypeScript Academy ?
Aucune expérience préalable n'est requise. TypeScript Academy sur CoddyKit est structuré pour les débutants jusqu'aux apprenants avancés, donc tu peux commencer ici ou depuis le début et avancer à ton rythme. Ceci est la leçon 2 sur 2.
Combien de temps prend la leçon « Analyse défensive et enveloppes d’erreur » ?
La plupart des leçons CoddyKit prennent environ 5–10 minutes. Chacune est courte et interactive, tu progresses régulièrement et tu repiques exactement où tu t'es arrêté sur le web et l'app.
Peux-tu écrire et exécuter du code dans cette leçon TypeScript Academy ?
Oui. Chaque leçon TypeScript Academy inclut un éditeur de code intégré, tu écris et exécutes du vrai code directement dans ton navigateur et tu reçois des retours IA instantanés — aucune configuration locale requise.
Toutes les leçons de ce cours
- Schémas zod/valibot et inférence
- Analyse défensive et enveloppes d’erreur