TypeScript Academy · Ders

parse ve safeParse

Doğrulamanın başarılı ve başarısız sonuçlarını uygun şekilde ele alın.

parse ve safeParse, CoddyKit'te ücretsiz bir TypeScript Academy dersidir. Bu, 4 dersinin 3. dersidir. Aşağıdan dersin tamamını ücretsiz okuyabilir, sonra tarayıcıda yerleşik kod editörü ve 7/24 yapay zeka koçu ile uygulamalı olarak pratik yapabilirsin. Bu, TypeScript Academy öğrenme yolunun bir parçasıdır ve ilerlemeniz web ve CoddyKit uygulaması arasında senkronize olur. TypeScript Academy kursu toplamda 4 dersten oluşur.

Doğrulamanın İki Yolu

Zod size iki doğrulama yöntemi sunar: parse geçersiz veride hata fırlatır, safeParse ise bunun yerine bir sonuç nesnesi döndürür.

import { z } from "zod";
const schema = z.string();
// schema.parse(x) throws on failure
// schema.safeParse(x) returns { success, ... }

parse Geçersiz Veride Hata Fırlatır

parse, başarı durumunda doğrulanmış değeri döndürür; başarısızlık durumunda ise ZodError fırlatır. Bu, geçersiz verilerin gerçekten istisnai olduğu durumlar için idealdir.

import { z } from "zod";
const schema = z.number();
const ok = schema.parse(42); // 42
// schema.parse("nope"); // throws ZodError

parse Hatalarını Yakalama

Fırlatılan hatayı ele almak ve neyin başarısız olduğuyla ilgili ayrıntıları incelemek için parse işlemini try/catch içine alın.

import { z } from "zod";
const schema = z.number();
try {
  schema.parse("nope");
} catch (err) {
  if (err instanceof z.ZodError) {
    console.log("Invalid:", err.issues.length);
  }
}

safeParse Sonuç Döndürür

safeParse hiçbir zaman hata fırlatmaz. success: true ve data ya da success: false ve error içeren bir nesne döndürür.

import { z } from "zod";
const schema = z.number();
const result = schema.safeParse("nope");
// result is { success: false, error: ZodError }

Sonucu Daraltma

Sonuç, success alanına göre ayrımlı bir birleşimdir. Bu alanı denetlemek sonucu data veya error olarak daraltır.

import { z } from "zod";
const schema = z.object({ id: z.number() });
const result = schema.safeParse({ id: 1 });
if (result.success) {
  console.log(result.data.id); // typed
} else {
  console.log(result.error.issues);
}

parse Ne Zaman Kullanılmalı?

Geçersiz girdinin bir hata olduğu veya işlemi durdurması gerektiği durumlarda, örneğin başlangıçta gerekli config değerini okurken parse kullanın.

import { z } from "zod";
const configSchema = z.object({ port: z.number() });
const config = configSchema.parse({ port: 8080 });
// Fail fast if config is wrong.

safeParse Ne Zaman Kullanılmalı?

Geçersiz girdinin beklenebildiği ve onu düzgün biçimde ele almak istediğiniz durumlarda, örneğin kullanıcı form gönderimlerini doğrularken safeParse kullanın.

import { z } from "zod";
const formSchema = z.object({ email: z.string() });
const r = formSchema.safeParse({ email: 123 });
if (!r.success) {
  // Show a friendly validation message
}

ZodError Sorunlarını Okuma

Bir ZodError, her sorunu açıklayan bir issues dizisi içerir: yol, ileti ve hata kodu.

import { z } from "zod";
const schema = z.object({ age: z.number() });
const r = schema.safeParse({ age: "x" });
if (!r.success) {
  for (const issue of r.error.issues) {
    console.log(issue.path, issue.message);
  }
}

Her İkisi de Çıkarılan Türü Döndürür

Başarı durumunda her iki yöntem de z.infer<typeof schema> olarak türlendirilmiş doğrulanmış değeri sağlar; böylece sonraki kod tamamen türlendirilmiş olur.

import { z } from "zod";
const userSchema = z.object({ name: z.string() });
type User = z.infer<typeof userSchema>;
const u: User = userSchema.parse({ name: "Ada" });
console.log(u.name);

Doğru Yöntemi Seçme

Genel kural: başarısızlık yürütmeyi durdurmalıysa güvenilir veya kritik yollar için parse; çökmeden ele almanız gereken güvenilmeyen girdiler için safeParse kullanın.

import { z } from "zod";
const schema = z.string();
// Critical: schema.parse(value)
// User-facing: schema.safeParse(value)

İki Yaklaşımı Birleştirme

Yaygın bir yaklaşım, safeParse işlemini türlendirilmiş veri veya biçimlendirilmiş hata döndüren bir yardımcı işlev içinde sarmalamaktır; böylece her iki yöntemin de kullanım kolaylığını elde edersiniz.

import { z } from "zod";
function validate<T extends z.ZodType>(schema: T, value: unknown) {
  const r = schema.safeParse(value);
  return r.success ? { ok: true, data: r.data } : { ok: false, error: r.error };
}
// Reusable, no throwing.

Hızlı Kontrol: parse ve safeParse

parse ile safeParse arasındaki farkı anlayıp anlamadığınızı sınayın.

Özet: parse ve safeParse

Geçersiz veride parse'ın hata fırlattığını, safeParse'ın ise success/error sonucu döndürdüğünü; her birinin ne zaman kullanılacağını ve ZodError sorunlarının nasıl okunacağını öğrendiniz.

import { z } from "zod";
const schema = z.object({ id: z.number() });
const r = schema.safeParse({ id: 1 });
if (r.success) console.log(r.data.id);

Sıkça Sorulan Sorular

“parse ve safeParse” dersi ücretsiz mi?

Evet — “parse ve safeParse” dersin tüm metni burada web'de ücretsiz olarak okunabilir. Etkileşimli olarak pratik yapmak (yerleşik kod editörü ve 7/24 yapay zeka koçu) ve TypeScript Academy kursunun geri kalanını açmak için CoddyKit PRO'ya yükselt. TypeScript Academy kursu toplamda 4 dersten oluşur.

“parse ve safeParse” dersinde ne öğreneceğim?

Doğrulamanın başarılı ve başarısız sonuçlarını uygun şekilde ele alın. TypeScript Academy ile uygulamalı kodu tarayıcıda doğrudan çalıştırarak pratik yaparsın ve 7/24 yapay zeka koçu dersi çalışırken sorularını yanıtlar.

TypeScript Academy öğrenmeye başlamak için deneyim gerekli mi?

Önceden deneyim gerekmez. CoddyKit'te TypeScript Academy, başlangıçtan ileri seviyeye kadar yapılandırıldığı için buradan başlayabilir veya başından başlayıp kendi hızında ilerleme yapabilirsin. Bu, 4 dersinin 3. dersidir.

“parse ve safeParse” dersi ne kadar sürer?

Çoğu CoddyKit dersi yaklaşık 5–10 dakika sürer. Her biri kısa ve etkileşimli olduğu için sabit ilerleme yaparsın ve web ile uygulama arasında tam olarak bıraktığın yerden devam edebilirsin.

Bu TypeScript Academy dersinde kod yazıp çalıştırabilir miyim?

Evet. Her TypeScript Academy dersi yerleşik bir kod editörü içerir, bu sayede tarayıcıda gerçek kod yazıp çalıştırabilir ve anlık yapay zeka geri bildirimi alırsın — yerel kurulum gerekli değildir.

Bu kursun tüm dersleri

← TypeScript Academy Sayfasına Dön