Penghuraian defensif dan sampul ralat
Bina pengendalian permintaan yang kukuh: huraikan data secara defensif, petakan semua kegagalan kepada sampul ralat JSON yang padat, dan elakkan pendedahan butiran dalaman.
Penghuraian defensif dan sampul ralat ialah pelajaran TypeScript Academy percuma di CoddyKit. Ini ialah pelajaran 2 daripada 2. Anda boleh membaca keseluruhan pelajaran di bawah secara percuma — kemudian berlatih secara praktikal dalam pelayar menggunakan penyunting kod terbina dalam dan tutor kecerdasan buatan 24/7. Pelajaran ini merupakan sebahagian daripada laluan pembelajaran TypeScript Academy, dan kemajuan anda disegerakkan merentas web serta aplikasi CoddyKit. Kursus TypeScript Academy merangkumi sejumlah 2 pelajaran.
Pengenalan
Matlamat: Huraikan input secara defensif dan sentiasa balas dengan sampul ralat JSON yang boleh dijangka. Kami akan mengekalkan pengesahan berdekatan dengan sempadan, menyeragamkan kegagalan, dan memastikan log kaya dengan maklumat sementara respons kekal minimum.
- safeParse pada semua input yang tidak dipercayai
- { ralat, kod, butiran? } yang konsisten
- Disiplin 4xx berbanding 5xx
Pemetaan sampul
Takrifkan ErrorEnvelope kecil yang boleh digunakan semula. Petakan ralat unknown kepadanya tanpa mendedahkan jejak tindanan.
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" } }
}Pembantu validate
Bungkus skema dalam pembantu validate yang mengembalikan hasil berpenanda. Pengendali kekal kecil dan konsisten.
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> }
}Pengendali defensif
Jalankan validate lebih awal; kembalikan 400 dengan butiran isu. Kegagalan yang tidak dijangka dihantar kepada perisian tengah ralat sebagai 500 bersama sampul.
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)
}Sampul biasa
Sediakan pembantu kecil untuk hasil biasa: 404/401 dengan rentetan code yang stabil supaya klien boleh membuat percabangan dengan boleh dipercayai.
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" } }
}Log berbanding respons
Seimbangkan log dengan respons: logkan ralat penuh pada bahagian pelayan (tindanan, ID permintaan, ID pengguna), tetapi kembalikan sampul minimum kepada klien. Pertimbangkan had kadar dan penyamaran untuk PII.
Pemeriksaan amali sampul
Pemeriksaan pantas: Bagaimanakah ralat pengesahan harus dikembalikan?
Ringkasan
Ringkasan: Sahkan input dengan safeParse, petakan kegagalan kepada sampul padat, dan asingkan log kaya daripada respons klien yang minimum.
Pelajari TypeScript dengan tutor kecerdasan buatan — percuma
Tulis dan jalankan kod sebenar dalam pelayar anda, dapatkan bantuan segera daripada tutor kecerdasan buatan yang tersedia 24/7, dan sambung semula dari tempat anda berhenti di web atau dalam aplikasi.
- Kursus
- 101
- Pelajaran
- 352
Soalan Lazim
Adakah pelajaran “Penghuraian defensif dan sampul ralat” percuma?
Ya — teks penuh “Penghuraian defensif dan sampul ralat” boleh dibaca secara percuma di web ini. Untuk berlatih secara interaktif menggunakan penyunting kod terbina dalam dan tutor kecerdasan buatan 24/7, serta membuka kunci baki kursus TypeScript Academy, tingkat taraf kepada CoddyKit PRO. Kursus TypeScript Academy merangkumi sejumlah 2 pelajaran.
Apakah yang akan saya pelajari dalam “Penghuraian defensif dan sampul ralat”?
Bina pengendalian permintaan yang kukuh: huraikan data secara defensif, petakan semua kegagalan kepada sampul ralat JSON yang padat, dan elakkan pendedahan butiran dalaman. Anda berlatih TypeScript Academy menggunakan kod praktikal yang dijalankan terus dalam pelayar, manakala tutor kecerdasan buatan 24/7 menjawab soalan anda semasa anda mengikuti pelajaran.
Adakah saya memerlukan pengalaman untuk memulakan TypeScript Academy?
Tiada pengalaman terdahulu diperlukan. Pembelajaran TypeScript Academy di CoddyKit disusun untuk pelajar daripada peringkat pemula hingga lanjutan, jadi anda boleh bermula di sini atau dari awal dan belajar mengikut kadar anda sendiri. Ini ialah pelajaran 2 daripada 2.
Berapa lamakah pelajaran “Penghuraian defensif dan sampul ralat” diambil?
Kebanyakan pelajaran CoddyKit mengambil masa kira-kira 5–10 minit. Setiap pelajaran ringkas dan interaktif, jadi anda boleh membuat kemajuan secara berterusan dan menyambung tepat dari tempat anda berhenti di web atau aplikasi.
Bolehkah saya menulis dan menjalankan kod dalam pelajaran TypeScript Academy ini?
Ya. Setiap pelajaran TypeScript Academy menyertakan penyunting kod terbina dalam, jadi anda boleh menulis dan menjalankan kod sebenar terus dalam pelayar serta menerima maklum balas kecerdasan buatan serta-merta — tanpa memerlukan persediaan setempat.
Semua pelajaran dalam kursus ini
- Skema zod/valibot + inferens
- Penghuraian defensif dan sampul ralat