{"id":31357,"date":"2025-10-09T01:31:40","date_gmt":"2025-10-08T22:31:40","guid":{"rendered":"https:\/\/fatihsoysal.com\/blog\/neverthrow-ve-byethrow-modern-hata-yonetimi-yaklasimlari-rehberi\/"},"modified":"2025-10-09T01:31:40","modified_gmt":"2025-10-08T22:31:40","slug":"neverthrow-ve-byethrow-modern-hata-yonetimi-yaklasimlari-rehberi","status":"publish","type":"post","link":"https:\/\/fatihsoysal.com\/blog\/neverthrow-ve-byethrow-modern-hata-yonetimi-yaklasimlari-rehberi\/","title":{"rendered":"Neverthrow ve Byethrow: Modern Hata Y\u00f6netimi Yakla\u015f\u0131mlar\u0131 Rehberi"},"content":{"rendered":"

<\/p>\n

Modern yaz\u0131l\u0131m geli\u015ftirme s\u00fcre\u00e7lerinde hata y\u00f6netimi, uygulaman\u0131z\u0131n kararl\u0131l\u0131\u011f\u0131 ve kullan\u0131c\u0131 deneyimi a\u00e7\u0131s\u0131ndan kritik bir \u00f6neme sahiptir. Peki ya geleneksel try-catch<\/code> bloklar\u0131, \u00f6zellikle Typescript’in tip g\u00fcvenli\u011fi avantajlar\u0131ndan tam olarak yararlanman\u0131z\u0131 engelliyorsa? Bu kapsaml\u0131 rehberde, tip g\u00fcvenli ve fonksiyonel bir hata y\u00f6netimi sa\u011flayan neverthrow<\/code> k\u00fct\u00fcphanesini ve asenkron i\u015flemler i\u00e7in \u00f6zel olarak tasarlanm\u0131\u015f byethrow<\/code> yakla\u015f\u0131m\u0131n\u0131 derinlemesine inceleyece\u011fiz. Uygulamal\u0131 \u00f6rnekler, vaka analizleri ve ileri d\u00fczey ipu\u00e7lar\u0131yla, kodunuzu daha sa\u011flam, okunabilir ve bak\u0131m\u0131 kolay hale getirme yollar\u0131n\u0131 ke\u015ffedece\u011fiz. Haz\u0131r m\u0131s\u0131n\u0131z? Kodunuzu bir sonraki seviyeye ta\u015f\u0131yal\u0131m!<\/p>\n

Yaz\u0131l\u0131m geli\u015ftirirken hatalar ka\u00e7\u0131n\u0131lmazd\u0131r; \u00f6nemli olan, bu hatalar\u0131 nas\u0131l ele ald\u0131\u011f\u0131m\u0131zd\u0131r. \u00c7o\u011fu geli\u015ftirici, \u00f6zellikle JavaScript ekosisteminde, hata y\u00f6netimi i\u00e7in standart try-catch<\/code> bloklar\u0131na g\u00fcvenir. Ancak bu yakla\u015f\u0131m, \u00f6zellikle b\u00fcy\u00fck ve karma\u015f\u0131k uygulamalarda, baz\u0131 \u00f6nemli dezavantajlar\u0131 beraberinde getirebilir. \u00d6ncelikle, try-catch<\/code> bloklar\u0131, bir fonksiyonun bir hata d\u00f6nd\u00fcr\u00fcp d\u00f6nd\u00fcrmeyece\u011fini veya hangi t\u00fcr hatay\u0131 d\u00f6nd\u00fcrece\u011fini fonksiyon imzas\u0131nda a\u00e7\u0131k\u00e7a belirtmez. Bu durum, kodun okunabilirli\u011fini azalt\u0131r ve beklenmedik runtime hatalar\u0131na yol a\u00e7abilir, zira geli\u015ftirici bir fonksiyonun potansiyel hata \u00e7\u0131kt\u0131s\u0131n\u0131 s\u00fcrekli olarak akl\u0131nda tutmak zorundad\u0131r.<\/p>\n

Try-Catch Blo\u011funun S\u0131n\u0131rl\u0131l\u0131klar\u0131 Nelerdir?<\/h3>\n

Geleneksel hata y\u00f6netimi, yani try-catch<\/code> mekanizmas\u0131, basit senaryolar i\u00e7in yeterli gibi g\u00f6r\u00fcnse de, modern ve tip g\u00fcvenli uygulamalar geli\u015ftirenler i\u00e7in baz\u0131 ciddi eksikliklere sahiptir. \u00d6rne\u011fin, bir TypeScript fonksiyonu a\u015fa\u011f\u0131daki gibi tan\u0131mlanm\u0131\u015f olabilir:<\/p>\n

\nfunction veriyiIsle(veri: string): string {\n  if (veri.length === 0) {\n    throw new Error(\"Bo\u015f veri g\u00f6nderilemez.\");\n  }\n  return veri.toUpperCase();\n}\n    <\/pre>\n
<\/code><\/p>\n
Bu fonksiyonun imzas\u0131 ((veri: string) => string<\/code>), asl\u0131nda bir hata f\u0131rlatabilece\u011fine dair hi\u00e7bir bilgi i\u00e7ermez. Bu, fonksiyonu \u00e7a\u011f\u0131ran geli\u015ftiricinin hatay\u0131 manuel olarak tahmin etmesini ve bir try-catch<\/code> blo\u011funa sarmas\u0131n\u0131 gerektirir. E\u011fer hata yakalanmazsa, uygulama \u00e7\u00f6ker. \u00dcstelik, f\u0131rlat\u0131lan hata tipi de genellikle any<\/code> olarak kabul edilir, bu da hata nesnesinin i\u00e7eri\u011fine eri\u015firken tip g\u00fcvenli\u011fini ortadan kald\u0131r\u0131r. Bu belirsizlik, \u00f6zellikle ekip i\u00e7inde \u00e7al\u0131\u015f\u0131rken veya b\u00fcy\u00fck kod tabanlar\u0131nda gezinirken hatalara zemin haz\u0131rlar. Kodun bak\u0131m\u0131n\u0131 zorla\u015ft\u0131r\u0131r ve hata ay\u0131klama s\u00fcre\u00e7lerini uzat\u0131r. Hatan\u0131n i\u015f ak\u0131\u015f\u0131n\u0131n do\u011fal bir par\u00e7as\u0131 olarak kabul edilmemesi, daha az \u00f6ng\u00f6r\u00fclebilir ve daha k\u0131r\u0131lgan sistemler in\u015fa etmemize neden olabilir.<\/p>\n
Result\/Either Tipi ile G\u00fcvenli \u00c7\u00f6z\u00fcmler: Neverthrow'un Temelleri<\/h3>\n
\u0130\u015fte tam da bu noktada, fonksiyonel programlama prensiplerinden ilham alan Result<\/code> (veya di\u011fer dillerde Either<\/code>) tipi devreye girer. neverthrow<\/code> k\u00fct\u00fcphanesi, JavaScript ve TypeScript geli\u015ftiricilerine bu g\u00fc\u00e7l\u00fc deseni sunarak, hata y\u00f6netimini daha deklaratif ve tip g\u00fcvenli bir hale getirir. Result<\/code> tipi, bir i\u015flemin ya ba\u015far\u0131l\u0131 bir de\u011fer (Ok<\/code>) ya da bir hata (Err<\/code>) d\u00f6nd\u00fcrece\u011fini a\u00e7\u0131k\u00e7a ifade eden bir birle\u015fim tipidir. Fonksiyon imzas\u0131nda bu tipi belirtmek, fonksiyonun potansiyel sonucunu derleme zaman\u0131nda bile anlar\u0131z. Bu sayede, hata y\u00f6netimi, kodun ayr\u0131lmaz bir par\u00e7as\u0131 haline gelir ve g\u00f6z ard\u0131 edilmesi zorla\u015f\u0131r.<\/p>\n
\nimport { ok, err, Result } from 'neverthrow';\n\nfunction veriyiIsleGuvenli(veri: string): Result {\n  if (veri.length === 0) {\n    return err(new Error(\"Bo\u015f veri g\u00f6nderilemez.\"));\n  }\n  return ok(veri.toUpperCase());\n}\n    <\/pre>\n
<\/code><\/p>\n
Yukar\u0131daki \u00f6rnekte, veriyiIsleGuvenli<\/code> fonksiyonu ya bir Ok<\/code> (ba\u015far\u0131l\u0131 sonu\u00e7) ya da bir Err<\/code> (hata durumu) d\u00f6nd\u00fcrece\u011fini a\u00e7\u0131k\u00e7a belirtir. Bu sayede, fonksiyonu kullanan herkes, olas\u0131 iki durumu da ele almak zorunda oldu\u011funu bilir ve derleyici, bu durumlar\u0131 ele almad\u0131\u011f\u0131n\u0131zda sizi uyar\u0131r. Bu yakla\u015f\u0131m, sadece hatan\u0131n varl\u0131\u011f\u0131n\u0131 de\u011fil, ayn\u0131 zamanda hata tipini de a\u00e7\u0131k\u00e7a tan\u0131mlad\u0131\u011f\u0131 i\u00e7in, daha detayl\u0131 hata i\u015fleme stratejileri geli\u015ftirmenize olanak tan\u0131r. Kod taban\u0131n\u0131n genel kalitesini art\u0131r\u0131r ve uzun vadede bak\u0131m maliyetlerini d\u00fc\u015f\u00fcr\u00fcr.<\/p>\n
Byethrow ile Asenkron D\u00fcnyada Sa\u011flaml\u0131k<\/h3>\n
neverthrow<\/code> k\u00fct\u00fcphanesi senkron i\u015flemler i\u00e7in m\u00fckemmel bir \u00e7\u00f6z\u00fcm sunarken, JavaScript'in asenkron do\u011fas\u0131, \u00f6zellikle Promise<\/code>'ler ve async\/await<\/code> ile \u00e7al\u0131\u015f\u0131rken farkl\u0131 bir meydan okuma getirir. Geleneksel olarak, asenkron hatalar .catch()<\/code> metotlar\u0131 veya try-catch<\/code> bloklar\u0131 ile ele al\u0131n\u0131r. Ancak bu, Promise<\/code> zincirlerinde hatan\u0131n nerede f\u0131rlat\u0131ld\u0131\u011f\u0131n\u0131 izlemeyi zorla\u015ft\u0131rabilir ve yine tip g\u00fcvenli\u011fi konusunda sorunlar yaratabilir. \u0130\u015fte bu noktada byethrow<\/code> devreye girer. byethrow<\/code>, Promise<\/code> tabanl\u0131 asenkron fonksiyonlar\u0131n neverthrow<\/code>'un Result<\/code> tipini d\u00f6nd\u00fcrmesini kolayla\u015ft\u0131ran bir adapt\u00f6rd\u00fcr. Temel olarak, bir Promise<\/code>'in ba\u015far\u0131l\u0131 sonucunu bir Ok<\/code> de\u011feriyle, reddedilen (rejected) sonucunu ise bir Err<\/code> de\u011feriyle sarmalar.<\/p>\n
\nimport { byethrow } from 'byethrow';\nimport { Result, ok, err } from 'neverthrow';\n\nasync function veriCekGuvenli(): Promise> {\n  const promise = new Promise((resolve, reject) => {\n    \/\/ Sim\u00fcle edilmi\u015f asenkron i\u015flem\n    setTimeout(() => {\n      const basariliMi = Math.random() > 0.5;\n      if (basariliMi) {\n        resolve(\"Sunucudan gelen veri!\");\n      } else {\n        reject(new Error(\"A\u011f ba\u011flant\u0131s\u0131 hatas\u0131!\"));\n      }\n    }, 1000);\n  });\n  return byethrow(promise);\n}\n    <\/pre>\n
<\/code><\/p>\n
byethrow<\/code> fonksiyonu sayesinde, asenkron bir operasyonun sonucunu tip g\u00fcvenli bir Result<\/code> olarak elde edebiliriz. Bu, asenkron hata y\u00f6netimini senkron hata y\u00f6netimine benzer bir yap\u0131ya kavu\u015fturarak, kodun tutarl\u0131l\u0131\u011f\u0131n\u0131 art\u0131r\u0131r. Geli\u015ftiriciler art\u0131k Promise<\/code> zincirlerinin her ad\u0131m\u0131nda potansiyel hatalar\u0131 tahmin etmek yerine, do\u011frudan Result<\/code> objesi \u00fczerinde \u00e7al\u0131\u015fabilir ve match<\/code> veya mapErr<\/code> gibi metodlarla hatay\u0131 i\u015fleyebilirler. Bu sayede, daha karma\u015f\u0131k asenkron ak\u0131\u015flarda bile kodun okunabilirli\u011fi ve hata i\u015fleme mant\u0131\u011f\u0131n\u0131n belirginli\u011fi korunur. Bu entegrasyon, modern web uygulamalar\u0131n\u0131n olmazsa olmaz\u0131 haline gelen asenkron i\u015flemlerde g\u00fcvenilirli\u011fi katlayarak art\u0131r\u0131r.<\/p>\n
Neverthrow ile Veri \u0130\u015fleme Ak\u0131\u015flar\u0131 Nas\u0131l G\u00fcvenli Hale Getirilir? Ad\u0131m Ad\u0131m Uygulama<\/h2>\n
neverthrow<\/code> k\u00fct\u00fcphanesi, uygulaman\u0131zdaki veri i\u015fleme ak\u0131\u015flar\u0131n\u0131 daha g\u00fcvenli ve \u00f6ng\u00f6r\u00fclebilir hale getirmenin anahtar\u0131d\u0131r. Tip g\u00fcvenli hata y\u00f6netimi sayesinde, potansiyel hatalar\u0131 derleme zaman\u0131nda yakalayabilir ve uygulaman\u0131z\u0131n beklenmedik \u00e7\u00f6k\u00fc\u015flerini en aza indirebilirsiniz. Bu b\u00f6l\u00fcmde, neverthrow<\/code>'u projelerinize nas\u0131l entegre edece\u011finizi, temel ok<\/code> ve err<\/code> yap\u0131lar\u0131n\u0131 nas\u0131l kullanaca\u011f\u0131n\u0131z\u0131 ve karma\u015f\u0131k veri i\u015fleme senaryolar\u0131nda nas\u0131l zincirleme metotlar uygulayaca\u011f\u0131n\u0131z\u0131 ad\u0131m ad\u0131m inceleyece\u011fiz. Bu pratik yakla\u015f\u0131m, hem yeni ba\u015flayanlar hem de deneyimli geli\u015ftiriciler i\u00e7in neverthrow<\/code>'un g\u00fcc\u00fcn\u00fc anlamalar\u0131n\u0131 kolayla\u015ft\u0131racakt\u0131r.<\/p>\n
Kurulum ve Temel ok<\/code>\/err<\/code> Kullan\u0131m\u0131<\/h3>\n
\u00d6ncelikle, projenize neverthrow<\/code>'u dahil etmeniz gerekiyor. Bu i\u015flem genellikle npm veya yarn ile yap\u0131l\u0131r:<\/p>\n
\nnpm install neverthrow\n# veya\nyarn add neverthrow\n    <\/pre>\n
<\/code><\/p>\n
Kurulum tamamland\u0131ktan sonra, neverthrow<\/code>'un temel yap\u0131 ta\u015flar\u0131 olan ok<\/code> ve err<\/code> fonksiyonlar\u0131n\u0131 kullanarak, bir i\u015flemin ba\u015far\u0131l\u0131 veya hatal\u0131 sonucunu temsil eden Result<\/code> nesneleri olu\u015fturabiliriz. A\u015fa\u011f\u0131daki \u00f6rnek, bir say\u0131sal girdi al\u0131p bunun ge\u00e7erli bir ya\u015f olup olmad\u0131\u011f\u0131n\u0131 kontrol eden basit bir fonksiyonu g\u00f6stermektedir:<\/p>\n
\nimport { ok, err, Result } from 'neverthrow';\n\n\/**\n * Bir ya\u015f de\u011ferinin ge\u00e7erli olup olmad\u0131\u011f\u0131n\u0131 kontrol eder.\n * @param yas Kontrol edilecek ya\u015f de\u011feri\n * @returns Ge\u00e7erliyse Ok, de\u011filse Err d\u00f6nd\u00fcr\u00fcr.\n *\/\nfunction yasDogrula(yas: number): Result {\n  if (yas < 0) {\n    return err(\"Ya\u015f negatif olamaz.\");\n  }\n  if (yas > 120) {\n    return err(\"Ya\u015f 120'den b\u00fcy\u00fck olamaz.\");\n  }\n  return ok(yas);\n}\n\n\/\/ Fonksiyonu kullanma \u00f6rnekleri\nconst gecerliYas = yasDogrula(30);\nif (gecerliYas.isOk()) {\n  console.log(Ge\u00e7erli ya\u015f: ${gecerliYas.value}<\/code>); \/\/ \u00c7\u0131kt\u0131: Ge\u00e7erli ya\u015f: 30\n} else {\n  console.error(Hata: ${gecerliYas.error}<\/code>);\n}\n\nconst gecersizYasNegatif = yasDogrula(-5);\nif (gecersizYasNegatif.isErr()) {\n  console.error(Hata: ${gecersizYasNegatif.error}<\/code>); \/\/ \u00c7\u0131kt\u0131: Hata: Ya\u015f negatif olamaz.\n}\n\nconst gecersizYasBuyuk = yasDogrula(150);\nif (gecersizYasBuyuk.isErr()) {\n  console.error(Hata: ${gecersizYasBuyuk.error}<\/code>); \/\/ \u00c7\u0131kt\u0131: Hata: Ya\u015f 120'den b\u00fcy\u00fck olamaz.\n}\n    <\/pre>\n
<\/code><\/p>\n
G\u00f6rd\u00fc\u011f\u00fcn\u00fcz gibi, Result<\/code> nesnesinin isOk()<\/code> ve isErr()<\/code> metotlar\u0131 ile sonucun tipini g\u00fcvenli bir \u015fekilde kontrol edebiliriz. Ayr\u0131ca, TypeScript derleyicisi bu kontrol\u00fc yapt\u0131ktan sonra, value<\/code> veya error<\/code> \u00f6zelliklerine eri\u015fti\u011fimizde do\u011fru tipi garanti eder.<\/p>\n
Zincirleme Metotlar (map<\/code>, andThen<\/code>) ile Karma\u015f\u0131k Ak\u0131\u015flar<\/h3>\n
neverthrow<\/code>'un ger\u00e7ek g\u00fcc\u00fc, Result<\/code> nesneleri \u00fczerinde uygulayabilece\u011finiz zincirleme (chaining) metotlarda yatar. Bu metotlar, bir dizi i\u015flemi s\u0131rayla uygulamam\u0131z\u0131 sa\u011flar, her ad\u0131mda hatay\u0131 zarif\u00e7e iletir veya ba\u015far\u0131l\u0131 sonucu d\u00f6n\u00fc\u015ft\u00fcr\u00fcr. En s\u0131k kullan\u0131lan metotlar map<\/code> ve andThen<\/code>'dir.<\/p>\n
    \n
  • map<\/code><\/strong>: E\u011fer Result<\/code> bir Ok<\/code> ise, i\u00e7erisindeki de\u011feri d\u00f6n\u00fc\u015ft\u00fcren bir fonksiyon uygular ve yeni bir Ok<\/code> d\u00f6nd\u00fcr\u00fcr. E\u011fer Result<\/code> bir Err<\/code> ise, hata de\u011ferini oldu\u011fu gibi ge\u00e7irir.<\/li>\n
  • andThen<\/code><\/strong>: E\u011fer Result<\/code> bir Ok<\/code> ise, i\u00e7erisindeki de\u011feri kullanarak yeni bir Result<\/code> d\u00f6nd\u00fcren bir fonksiyon uygular. Bu, bir \u00f6nceki i\u015flemin ba\u015far\u0131l\u0131 sonucunu al\u0131p, bir sonraki potansiyel olarak hatal\u0131 i\u015flemi ba\u015flatmak i\u00e7in kullan\u0131l\u0131r.<\/li>\n<\/ul>\n
    A\u015fa\u011f\u0131daki \u00f6rnekte, zincirleme metotlar\u0131 kullanarak bir kullan\u0131c\u0131n\u0131n ya\u015f\u0131n\u0131 do\u011frulama ve ard\u0131ndan bu ya\u015f\u0131 kullanarak karma\u015f\u0131k bir hesaplama yapma s\u00fcrecini g\u00f6rebilirsiniz:<\/p>\n
    \nimport { ok, err, Result } from 'neverthrow';\n\nfunction yasDogrula(yasStr: string): Result {\n  const yasNum = parseInt(yasStr, 10);\n  if (isNaN(yasNum)) {\n    return err(\"Ge\u00e7erli bir say\u0131sal ya\u015f giriniz.\");\n  }\n  if (yasNum < 0 || yasNum > 120) {\n    return err(\"Ya\u015f 0 ile 120 aras\u0131nda olmal\u0131d\u0131r.\");\n  }\n  return ok(yasNum);\n}\n\nfunction yasHesapla(yas: number): Result {\n  if (yas < 18) {\n    return err(\"Re\u015fit olmayanlar i\u00e7in i\u015flem yap\u0131lamaz.\");\n  }\n  return ok(Kullan\u0131c\u0131 ${yas} ya\u015f\u0131nda ve re\u015fittir. Emeklili\u011fine ${65 - yas} y\u0131l kald\u0131.<\/code>);\n}\n\n\/\/ Zincirleme kullan\u0131m\nfunction kullaniciIsle(yasGirdisi: string): Result {\n  return yasDogrula(yasGirdisi) \/\/ \u0130lk olarak ya\u015f\u0131 do\u011frula\n    .andThen(yasHesapla)       \/\/ Ya\u015f ge\u00e7erliyse hesaplamay\u0131 yap\n    .mapErr(hata => Kullan\u0131c\u0131 i\u015flemi hatas\u0131: ${hata}<\/code>); \/\/ Hata olursa mesaj\u0131 d\u00f6n\u00fc\u015ft\u00fcr\n}\n\n\/\/ \u00d6rnek \u00e7a\u011fr\u0131lar\nconst sonuc1 = kullaniciIsle(\"25\");\nconsole.log(sonuc1.isOk() ? sonuc1.value : sonuc1.error);\n\/\/ \u00c7\u0131kt\u0131: Kullan\u0131c\u0131 25 ya\u015f\u0131nda ve re\u015fittir. Emeklili\u011fine 40 y\u0131l kald\u0131.\n\nconst sonuc2 = kullaniciIsle(\"onsekiz\");\nconsole.log(sonuc2.isOk() ? sonuc2.value : sonuc2.error);\n\/\/ \u00c7\u0131kt\u0131: Kullan\u0131c\u0131 i\u015flemi hatas\u0131: Ge\u00e7erli bir say\u0131sal ya\u015f giriniz.\n\nconst sonuc3 = kullaniciIsle(\"10\");\nconsole.log(sonuc3.isOk() ? sonuc3.value : sonuc3.error);\n\/\/ \u00c7\u0131kt\u0131: Kullan\u0131c\u0131 i\u015flemi hatas\u0131: Re\u015fit olmayanlar i\u00e7in i\u015flem yap\u0131lamaz.\n    <\/pre>\n
    <\/code><\/p>\n
    Bu \u00f6rnekte, yasDogrula<\/code> ve yasHesapla<\/code> fonksiyonlar\u0131 birbirine zincirlenerek, karma\u015f\u0131k bir do\u011frulama ve i\u015fleme ak\u0131\u015f\u0131 olu\u015fturulmu\u015ftur. Herhangi bir ad\u0131mda bir hata olu\u015ftu\u011funda, zincirleme i\u015flemi durur ve hata do\u011frudan sonuca yans\u0131r. Bu, kodun ak\u0131\u015f\u0131n\u0131 \u00e7ok daha net hale getirir ve hata durumlar\u0131n\u0131n her ad\u0131mda manuel olarak kontrol edilmesini gereksiz k\u0131lar.<\/p>\n
    Ger\u00e7ek D\u00fcnya Senaryosu: Kullan\u0131c\u0131 Kay\u0131t Formu Do\u011frulamas\u0131 (Vaka Analizi)<\/h3>\n
    Bir kullan\u0131c\u0131 kay\u0131t formunu d\u00fc\u015f\u00fcn\u00fcn. Kullan\u0131c\u0131n\u0131n ad\u0131n\u0131, e-posta adresini ve \u015fifresini girmesi gerekiyor. Bu verilerin her biri i\u00e7in farkl\u0131 do\u011frulama kurallar\u0131 vard\u0131r ve bir hata durumunda, kullan\u0131c\u0131ya spesifik bir mesaj g\u00f6ndermek isteriz. \u0130\u015fte neverthrow<\/code> ile bu senaryoyu nas\u0131l ele alabilece\u011fimiz:<\/p>\n
    \nimport { ok, err, Result, combine } from 'neverthrow';\n\ninterface KullaniciKayitVerisi {\n  ad: string;\n  email: string;\n  sifre: string;\n}\n\n\/\/ Hata tiplerini tan\u0131mlayal\u0131m\ntype KayitHatasi =\n  | { type: 'GecersizAd', mesaj: string }\n  | { type: 'GecersizEmail', mesaj: string }\n  | { type: 'ZayifSifre', mesaj: string };\n\nfunction adDogrula(ad: string): Result {\n  if (ad.length < 3) {\n    return err({ type: 'GecersizAd', mesaj: \"Ad en az 3 karakter olmal\u0131.\" });\n  }\n  return ok(ad);\n}\n\nfunction emailDogrula(email: string): Result {\n  if (!email.includes('@') || !email.includes('.')) {\n    return err({ type: 'GecersizEmail', mesaj: \"Ge\u00e7erli bir e-posta adresi giriniz.\" });\n  }\n  return ok(email);\n}\n\nfunction sifreDogrula(sifre: string): Result {\n  if (sifre.length < 8 || !\/[A-Z]\/.test(sifre) || !\/\\d\/.test(sifre)) {\n    return err({ type: 'ZayifSifre', mesaj: \"\u015eifre en az 8 karakter, b\u00fcy\u00fck harf ve rakam i\u00e7ermeli.\" });\n  }\n  return ok(sifre);\n}\n\n\/\/ T\u00fcm do\u011frulama ad\u0131mlar\u0131n\u0131 birle\u015ftiren fonksiyon\nfunction kullaniciKayitDogrula(veri: KullaniciKayitVerisi): Result {\n  const adSonuc = adDogrula(veri.ad);\n  const emailSonuc = emailDogrula(veri.email);\n  const sifreSonuc = sifreDogrula(veri.sifre);\n\n  \/\/ combine ile birden fazla Result'\u0131 birle\u015ftirebiliriz\n  const tumSonuclar = combine([adSonuc, emailSonuc, sifreSonuc]);\n\n  return tumSonuclar.map(([ad, email, sifre]) => ({ ad, email, sifre }))\n                   .mapErr(errors => errors.flat()); \/\/ Hatalar\u0131 d\u00fcz bir diziye d\u00f6n\u00fc\u015ft\u00fcr\n}\n\n\/\/ Test senaryolar\u0131\nconst basariliKayit: KullaniciKayitVerisi = {\n  ad: \"Caner\",\n  email: \"caner@example.com\",\n  sifre: \"Sifre123!\"\n};\n\nconst hatalarIleKayit: KullaniciKayitVerisi = {\n  ad: \"Ca\", \/\/ K\u0131sa ad\n  email: \"caner.com\", \/\/ Ge\u00e7ersiz email\n  sifre: \"sifre\" \/\/ Zay\u0131f \u015fifre\n};\n\nconst sonucBasarili = kullaniciKayitDogrula(basariliKayit);\nif (sonucBasarili.isOk()) {\n  console.log(\"Kullan\u0131c\u0131 ba\u015far\u0131yla do\u011fruland\u0131:\", sonucBasarili.value);\n} else {\n  console.error(\"Kullan\u0131c\u0131 do\u011frulama hatalar\u0131:\", sonucBasarili.error);\n}\n\nconst sonucHatalar = kullaniciKayitDogrula(hatalarIleKayit);\nif (sonucHatalar.isErr()) {\n  console.error(\"Kullan\u0131c\u0131 do\u011frulama hatalar\u0131:\", sonucHatalar.error);\n  \/\/ \u00c7\u0131kt\u0131: Kullan\u0131c\u0131 do\u011frulama hatalar\u0131:\n  \/\/ [ { type: 'GecersizAd', mesaj: 'Ad en az 3 karakter olmal\u0131.' },\n  \/\/   { type: 'GecersizEmail', mesaj: 'Ge\u00e7erli bir e-posta adresi giriniz.' },\n  \/\/   { type: 'ZayifSifre', mesaj: '\u015eifre en az 8 karakter, b\u00fcy\u00fck harf ve rakam i\u00e7ermeli.' } ]\n}\n    <\/pre>\n
    <\/code><\/p>\n
    Bu vaka analizinde, combine<\/code> fonksiyonunu kullanarak birden fazla Result<\/code>'\u0131 ayn\u0131 anda i\u015fleyebiliyoruz. E\u011fer t\u00fcm do\u011frulama ad\u0131mlar\u0131 ba\u015far\u0131l\u0131 olursa, combine<\/code> bir Ok<\/code> de\u011feri d\u00f6nd\u00fcr\u00fcr. Aksi takdirde, olu\u015fan t\u00fcm hatalar\u0131 i\u00e7eren bir Err<\/code> de\u011feri d\u00f6ner. Bu yakla\u015f\u0131m, kullan\u0131c\u0131 kay\u0131t formlar\u0131 gibi birden fazla do\u011frulama ad\u0131m\u0131n\u0131n oldu\u011fu senaryolarda son derece kullan\u0131\u015fl\u0131d\u0131r, zira t\u00fcm hatalar\u0131 tek bir \u00e7at\u0131 alt\u0131nda toplay\u0131p kullan\u0131c\u0131ya anlaml\u0131 geri bildirimler sunabiliriz. neverthrow<\/code> ile hata y\u00f6netimi sadece daha g\u00fcvenli olmakla kalmaz, ayn\u0131 zamanda daha esnek ve kullan\u0131c\u0131 dostu hale gelir.<\/p>\n
    Asenkron Uygulamalarda Byethrow ile Hata Y\u00f6netimi: API ve Veritaban\u0131<\/h2>\n
    Modern web uygulamalar\u0131, kullan\u0131c\u0131 aray\u00fcz\u00fcn\u00fc engellemeden arka planda veri \u00e7ekme veya g\u00f6nderme gibi asenkron i\u015flemlerle doludur. JavaScript'in Promise<\/code>'ler ve async\/await<\/code> s\u00f6zdizimi, bu t\u00fcr i\u015flemleri y\u00f6netmek i\u00e7in standart bir yol sunsa da, tip g\u00fcvenli hata y\u00f6netimi konusunda baz\u0131 bo\u015fluklar b\u0131rak\u0131r. byethrow<\/code> k\u00fct\u00fcphanesi, neverthrow<\/code>'un sundu\u011fu Result<\/code> tipini asenkron d\u00fcnyaya ta\u015f\u0131yarak bu bo\u015fluklar\u0131 doldurur. B\u00f6ylece, API \u00e7a\u011fr\u0131lar\u0131, veritaban\u0131 etkile\u015fimleri veya dosya okuma\/yazma gibi t\u00fcm asenkron operasyonlarda da ayn\u0131 tutarl\u0131 ve tip g\u00fcvenli hata y\u00f6netimini uygulayabiliriz. Bu b\u00f6l\u00fcm, byethrow<\/code>'un Promise'lerle nas\u0131l entegre oldu\u011funu ve async\/await<\/code> ile nas\u0131l sorunsuz \u00e7al\u0131\u015ft\u0131\u011f\u0131n\u0131 detayl\u0131 bir \u015fekilde a\u00e7\u0131klayacakt\u0131r.<\/p>\n
    Byethrow ve Promise Entegrasyonu<\/h3>\n
    byethrow<\/code>'un temel i\u015flevi, standart bir Promise<\/code>'i al\u0131p, onun \u00e7\u00f6z\u00fcm\u00fcn\u00fc (resolve) bir Ok<\/code> de\u011ferine, reddedilmesini (reject) ise bir Err<\/code> de\u011ferine d\u00f6n\u00fc\u015ft\u00fcrmektir. Bu, bir Promise<\/code>'in sonucunu do\u011frudan neverthrow<\/code>'un Result<\/code> tipi ile uyumlu hale getirir ve t\u00fcm Result<\/code> metotlar\u0131n\u0131 asenkron operasyonlarda da kullanmam\u0131z\u0131 sa\u011flar. A\u015fa\u011f\u0131daki \u00f6rnekte, sahte bir API \u00e7a\u011fr\u0131s\u0131 ile bu entegrasyonu g\u00f6rebilirsiniz:<\/p>\n
    \nimport { byethrow } from 'byethrow';\nimport { Result, ok, err } from 'neverthrow';\n\n\/\/ \u00d6zel hata tipleri tan\u0131mlayabiliriz\ntype ApiHatasi = 'NetworkError' | 'ServerError' | 'Unauthorized';\n\n\/**\n * Sahte bir API \u00e7a\u011fr\u0131s\u0131n\u0131 sim\u00fcle eder.\n * @param shouldFail \u0130\u015flemin ba\u015far\u0131s\u0131z olup olmayaca\u011f\u0131n\u0131 belirler.\n * @returns Promise>\n *\/\nasync function veriCekApi(shouldFail: boolean): Promise> {\n  const promise = new Promise((resolve, reject) => {\n    setTimeout(() => {\n      if (shouldFail) {\n        \/\/ Hata t\u00fcrlerini dinamik olarak se\u00e7elim\n        const randomError = Math.random();\n        if (randomError < 0.33) reject('NetworkError');\n        else if (randomError < 0.66) reject('ServerError');\n        else reject('Unauthorized');\n      } else {\n        resolve(\"API'den ba\u015far\u0131yla veri al\u0131nd\u0131: Kullan\u0131c\u0131 listesi\");\n      }\n    }, 1500); \/\/ 1.5 saniye gecikme\n  });\n  return byethrow(promise); \/\/ Promise'i Result'a d\u00f6n\u00fc\u015ft\u00fcr\n}\n\n\/\/ Kullan\u0131m \u00f6rnekleri\nasync function testApiCagrisi() {\n  console.log(\"Ba\u015far\u0131l\u0131 API \u00e7a\u011fr\u0131s\u0131 deneniyor...\");\n  const sonucBasarili = await veriCekApi(false);\n  if (sonucBasarili.isOk()) {\n    console.log(\"\u2705 Ba\u015far\u0131l\u0131 sonu\u00e7:\", sonucBasarili.value);\n  } else {\n    console.error(\"\u274c Hata:\", sonucBasarili.error);\n  }\n\n  console.log(\"\\nHatal\u0131 API \u00e7a\u011fr\u0131s\u0131 deneniyor...\");\n  const sonucHata = await veriCekApi(true);\n  if (sonucHata.isErr()) {\n    console.error(\"\u274c Hata:\", sonucHata.error);\n  } else {\n    console.log(\"\u2705 Ba\u015far\u0131l\u0131 sonu\u00e7:\", sonucHata.value); \/\/ Bu k\u0131sma asla ula\u015f\u0131lmamal\u0131\n  }\n}\n\ntestApiCagrisi();\n    <\/pre>\n
    <\/code><\/p>\n
    Bu kod blo\u011funda, veriCekApi<\/code> fonksiyonu do\u011frudan bir Promise><\/code> d\u00f6nd\u00fcr\u00fcyor. Bu sayede, fonksiyonu \u00e7a\u011f\u0131ran ki\u015fi, API'den bir de\u011fer bekledi\u011fi kadar, belirli ApiHatasi<\/code> tiplerinden biriyle de kar\u015f\u0131la\u015fabilece\u011fini derleme zaman\u0131nda bilir. Bu, geli\u015ftiricilere hatalar\u0131 daha proaktif bir \u015fekilde ele alma imkan\u0131 sunar ve asenkron kodda tip g\u00fcvenli\u011fini \u00f6nemli \u00f6l\u00e7\u00fcde art\u0131r\u0131r. Hata i\u015fleme mant\u0131\u011f\u0131, ba\u015far\u0131l\u0131 durum kadar belirgin hale gelir.<\/p>\n
    Async\/Await ile Temiz ve Okunabilir Asenkron Kod<\/h3>\n
    byethrow<\/code> ve neverthrow<\/code>'un kombinasyonu, async\/await<\/code> ile birle\u015fti\u011finde son derece temiz ve okunabilir bir asenkron kod ak\u0131\u015f\u0131 sa\u011flar. Art\u0131k, try-catch<\/code> bloklar\u0131na g\u00fcvenmek yerine, Result<\/code> nesnesinin metotlar\u0131n\u0131 kullanarak hata durumlar\u0131n\u0131 zarif\u00e7e i\u015fleyebiliriz. Bu, kodun hem lineer okunmas\u0131n\u0131 hem de fonksiyonel programlama prensiplerine uygunlu\u011funu art\u0131r\u0131r.<\/p>\n
    \nimport { byethrow } from 'byethrow';\nimport { Result, ok, err } from 'neverthrow';\n\ntype VeritabaniHatasi = { kod: number, mesaj: string };\n\nasync function kullaniciBilgisiCek(kullaniciId: string): Promise> {\n  \/\/ Sahte veritaban\u0131 i\u015flemi\n  const promise = new Promise<{ id: string, ad: string }>((resolve, reject) => {\n    setTimeout(() => {\n      if (kullaniciId === \"123\") {\n        resolve({ id: \"123\", ad: \"Mehmet Y\u0131lmaz\" });\n      } else if (kullaniciId === \"hata\") {\n        reject({ kod: 500, mesaj: \"Veritaban\u0131 ba\u011flant\u0131s\u0131 kesildi.\" });\n      } else {\n        reject({ kod: 404, mesaj: \"Kullan\u0131c\u0131 bulunamad\u0131.\" });\n      }\n    }, 800);\n  });\n  return byethrow(promise);\n}\n\nasync function kullaniciProfiliniGoster(id: string) {\n  const kullaniciSonuc = await kullaniciBilgisiCek(id);\n\n  \/\/ match metodu ile sonucu zarif\u00e7e ele alabiliriz\n  return kullaniciSonuc.match(\n    (kullanici) => {\n      console.log(\ud83d\udc64 Kullan\u0131c\u0131 Profili: ${kullanici.ad} (ID: ${kullanici.id})<\/code>);\n      return Profil: ${kullanici.ad}<\/code>;\n    },\n    (hata) => {\n      console.error(\u274c Profil y\u00fcklenemedi. Hata kodu: ${hata.kod}, Mesaj: ${hata.mesaj}<\/code>);\n      return Hata: ${hata.mesaj}<\/code>;\n    }\n  );\n}\n\nconsole.log(\"--- Kullan\u0131c\u0131 Profili G\u00f6sterimi ---\");\nawait kullaniciProfiliniGoster(\"123\"); \/\/ Ba\u015far\u0131l\u0131\nawait kullaniciProfiliniGoster(\"999\"); \/\/ Kullan\u0131c\u0131 bulunamad\u0131 hatas\u0131\nawait kullaniciProfiliniGoster(\"hata\"); \/\/ Veritaban\u0131 hatas\u0131\n    <\/pre>\n
    <\/code><\/p>\n
    Bu \u00f6rnekte, match<\/code> metodunu kullanarak Result<\/code> nesnesinin hem ba\u015far\u0131l\u0131 (Ok<\/code>) hem de hatal\u0131 (Err<\/code>) durumlar\u0131n\u0131 tek bir yerde, son derece okunakl\u0131 bir \u015fekilde ele alabiliyoruz. async\/await<\/code> ile birle\u015fen byethrow<\/code>, asenkron kodda karma\u015f\u0131kl\u0131\u011f\u0131 azalt\u0131rken, uygulaman\u0131z\u0131n hataya dayan\u0131kl\u0131l\u0131\u011f\u0131n\u0131 ve s\u00fcrd\u00fcr\u00fclebilirli\u011fini art\u0131r\u0131r. B\u00f6ylece, hata i\u015fleme mant\u0131\u011f\u0131 kodun \u00e7ekirdek ak\u0131\u015f\u0131ndan ayr\u0131lmaz ve uygulaman\u0131n genel sa\u011fl\u0131\u011f\u0131n\u0131 daha net bir \u015fekilde yans\u0131t\u0131r.<\/p>\n
    Vaka Analizi: \u00dcr\u00fcn Bilgisi \u00c7ekme ve G\u00fcncelleme \u0130\u015flemleri<\/h3>\n
    E-ticaret uygulamalar\u0131nda \u00fcr\u00fcn bilgilerini API'den \u00e7ekme ve g\u00fcncelleme i\u015flemleri s\u0131k\u00e7a kar\u015f\u0131la\u015f\u0131lan asenkron senaryolard\u0131r. Bu i\u015flemlerde a\u011f hatalar\u0131, sunucu hatalar\u0131 veya do\u011frulama hatalar\u0131 gibi bir\u00e7ok farkl\u0131 problemle kar\u015f\u0131la\u015fabiliriz. byethrow<\/code> ve neverthrow<\/code> kullanarak bu s\u00fcreci nas\u0131l daha sa\u011flam hale getirebilece\u011fimizi inceleyelim.<\/p>\n
    \nimport { byethrow } from 'byethrow';\nimport { Result, ok, err, combine } from 'neverthrow';\n\ntype UrunHatasi =\n  | { type: 'UrunBulunamadi', id: string, mesaj: string }\n  | { type: 'ApiHatasi', status: number, mesaj: string }\n  | { type: 'GecersizVeri', field: string, mesaj: string };\n\ninterface Urun {\n  id: string;\n  ad: string;\n  fiyat: number;\n  stok: number;\n}\n\n\/\/ Sahte bir API \u00e7a\u011fr\u0131s\u0131\nasync function urunCek(urunId: string): Promise> {\n  const promise = new Promise((resolve, reject) => {\n    setTimeout(() => {\n      if (urunId === \"PROD001\") {\n        resolve({ id: \"PROD001\", ad: \"Ak\u0131ll\u0131 Telefon\", fiyat: 5000, stok: 100 });\n      } else if (urunId === \"FAIL001\") {\n        reject({ type: 'ApiHatasi', status: 500, mesaj: \"Sunucu hatas\u0131.\" });\n      } else {\n        reject({ type: 'UrunBulunamadi', id: urunId, mesaj: \"\u00dcr\u00fcn bulunamad\u0131.\" });\n      }\n    }, 700);\n  });\n  return byethrow(promise);\n}\n\nasync function urunGuncelle(urun: Urun): Promise> {\n  \/\/ Basit bir veri do\u011frulama\n  if (urun.fiyat <= 0) {\n    return ok(err({ type: 'GecersizVeri', field: 'fiyat', mesaj: \"Fiyat s\u0131f\u0131rdan b\u00fcy\u00fck olmal\u0131.\" }))._unsafeUnwrapErr();\n  }\n  if (urun.stok < 0) {\n    return ok(err({ type: 'GecersizVeri', field: 'stok', mesaj: \"Stok negatif olamaz.\" }))._unsafeUnwrapErr();\n  }\n\n  const promise = new Promise((resolve, reject) => {\n    setTimeout(() => {\n      \/\/ Sim\u00fcle edilmi\u015f g\u00fcncelleme ba\u015far\u0131l\u0131\n      resolve({ ...urun, ad: urun.ad + \" (G\u00fcncellendi)\" });\n    }, 500);\n  });\n  return byethrow(promise);\n}\n\n\/\/ Bir \u00fcr\u00fcn\u00fc \u00e7ekme, fiyat\u0131n\u0131 art\u0131rma ve g\u00fcncelleme\nasync function urunIslemAkisi(urunId: string, yeniFiyat: number) {\n  const cekmeSonuc = await urunCek(urunId);\n\n  return cekmeSonuc\n    .andThen(async (urun) => { \/\/ \u00dcr\u00fcn \u00e7ekme ba\u015far\u0131l\u0131ysa devam et\n      const guncellenecekUrun = { ...urun, fiyat: yeniFiyat };\n      return urunGuncelle(guncellenecekUrun); \/\/ \u00dcr\u00fcn\u00fc g\u00fcncelle\n    })\n    .map((guncellenenUrun) => { \/\/ T\u00fcm ad\u0131mlar ba\u015far\u0131l\u0131ysa\n      console.log(\u2705 \u00dcr\u00fcn ba\u015far\u0131yla g\u00fcncellendi: ${guncellenenUrun.ad}, Yeni Fiyat: ${guncellenenUrun.fiyat}<\/code>);\n      return guncellenenUrun;\n    })\n    .mapErr((hata) => { \/\/ Herhangi bir ad\u0131mda hata olursa\n      console.error(\u274c \u00dcr\u00fcn i\u015flem hatas\u0131:<\/code>, hata);\n      return hata;\n    });\n}\n\nconsole.log(\"--- \u00dcr\u00fcn \u0130\u015flem Ak\u0131\u015f\u0131 Testleri ---\");\nawait urunIslemAkisi(\"PROD001\", 5500); \/\/ Ba\u015far\u0131l\u0131 ak\u0131\u015f\nawait urunIslemAkisi(\"NONEXISTENT\", 6000); \/\/ \u00dcr\u00fcn bulunamad\u0131\nawait urunIslemAkisi(\"PROD001\", -100); \/\/ Ge\u00e7ersiz fiyat verisi\nawait urunIslemAkisi(\"FAIL001\", 5200); \/\/ API hatas\u0131\n    <\/pre>\n
    <\/code><\/p>\n
    Bu vaka analizinde, byethrow<\/code> ve neverthrow<\/code>'un asenkron zincirleme yeteneklerini kullanarak karma\u015f\u0131k bir \u00fcr\u00fcn i\u015fleme ak\u0131\u015f\u0131n\u0131 nas\u0131l olu\u015fturdu\u011fumuzu g\u00f6steriyoruz. urunCek<\/code> fonksiyonu, bir \u00fcr\u00fcn\u00fc API'den g\u00fcvenli bir \u015fekilde \u00e7ekerken, urunGuncelle<\/code> ise veriyi do\u011frulayarak ve asenkron bir g\u00fcncelleme i\u015flemi yaparak bir Result<\/code> d\u00f6nd\u00fcr\u00fcr. andThen<\/code> metodu sayesinde, bu iki asenkron i\u015flemi birbirine ba\u011flayabiliyor ve zincirdeki herhangi bir ad\u0131mda olu\u015fabilecek hatalar\u0131 tek bir noktada, tip g\u00fcvenli bir \u015fekilde ele alabiliyoruz. Bu sayede, hem kodun okunabilirli\u011fi art\u0131yor hem de hata i\u015fleme mant\u0131\u011f\u0131 daha tutarl\u0131 ve tahmin edilebilir hale geliyor.<\/p>\n
    Geli\u015fmi\u015f Neverthrow Teknikleri ve Bak\u0131m Kolayl\u0131\u011f\u0131 \u0130\u00e7in \u0130pu\u00e7lar\u0131 Nelerdir?<\/h2>\n
    neverthrow<\/code> ve byethrow<\/code> k\u00fct\u00fcphaneleri, hata y\u00f6netiminizi temelden d\u00f6n\u00fc\u015ft\u00fcrecek g\u00fc\u00e7l\u00fc ara\u00e7lar sunar. Ancak, bu ara\u00e7lar\u0131n tam potansiyelini kullanmak ve uygulamalar\u0131n\u0131z\u0131n uzun vadeli bak\u0131m\u0131n\u0131 kolayla\u015ft\u0131rmak i\u00e7in baz\u0131 ileri d\u00fczey teknikleri ve en iyi uygulamalar\u0131 bilmek \u00f6nemlidir. Bu b\u00f6l\u00fcmde, \u00f6zel hata tipleri olu\u015fturarak TypeScript'in tip g\u00fcvenli\u011fini nas\u0131l daha da g\u00fc\u00e7lendirebilece\u011finizi, performans optimizasyonu i\u00e7in dikkat etmeniz gerekenleri ve kod okunabilirli\u011fini en \u00fcst d\u00fczeye \u00e7\u0131karmak i\u00e7in ipu\u00e7lar\u0131n\u0131 ke\u015ffedece\u011fiz. Ayr\u0131ca, uygulamalar\u0131n\u0131z\u0131n sadece mant\u0131ksal olarak de\u011fil, ayn\u0131 zamanda kullan\u0131c\u0131 aray\u00fcz\u00fc a\u00e7\u0131s\u0131ndan da sa\u011flam olmas\u0131n\u0131 sa\u011flayan mobil uyumluluk ve responsive tasar\u0131m gibi genel geli\u015ftirme notlar\u0131na da de\u011finece\u011fiz.<\/p>\n
    \u00d6zel Hata Tipleri ve Typescript ile G\u00fc\u00e7l\u00fc Tip G\u00fcvenli\u011fi<\/h3>\n
    neverthrow<\/code>'un en b\u00fcy\u00fck avantajlar\u0131ndan biri, hata tiplerini tamamen sizin belirlemenize olanak sa\u011flamas\u0131d\u0131r. Bu, uygulaman\u0131z\u0131n her yerinde tutarl\u0131 ve anlaml\u0131 hata mesajlar\u0131 kullanabilece\u011finiz anlam\u0131na gelir. TypeScript ile \u00f6zel hata tipleri tan\u0131mlamak, hatalar\u0131 yakalad\u0131\u011f\u0131n\u0131zda belirli hata t\u00fcrlerine g\u00f6re farkl\u0131 i\u015flem yapman\u0131z\u0131 sa\u011flar ve runtime hatalar\u0131n\u0131 \u00f6nemli \u00f6l\u00e7\u00fcde azalt\u0131r. \u00d6rne\u011fin, bir API hatas\u0131 i\u00e7in sadece bir string<\/code> yerine, hata kodu, mesaj\u0131 ve belki de bir neden gibi daha zengin bir nesne tan\u0131mlayabiliriz:<\/p>\n
    \nimport { Result, ok, err } from 'neverthrow';\n\ninterface UrunVeriHatasi {\n  type: 'UrunBulunamadi' | 'GecersizUrunID';\n  message: string;\n  timestamp: Date;\n}\n\ninterface SepetIslemHatasi {\n  type: 'StokYetersiz' | 'KullaniciYetkisiz';\n  message: string;\n  sepetId?: string;\n}\n\ntype SistemHatasi = UrunVeriHatasi | SepetIslemHatasi;\n\nfunction urunGetir(id: string): Result {\n  if (id === \"INVALID\") {\n    return err({ type: 'GecersizUrunID', message: '\u00dcr\u00fcn ID format\u0131 yanl\u0131\u015f.', timestamp: new Date() });\n  }\n  if (id === \"404\") {\n    return err({ type: 'UrunBulunamadi', message: ID'si ${id} olan \u00fcr\u00fcn bulunamad\u0131.<\/code>, timestamp: new Date() });\n  }\n  return ok(\u00dcr\u00fcn ba\u015far\u0131yla getirildi: ${id}<\/code>);\n}\n\nfunction sepeteEkle(urunId: string, miktar: number): Result {\n  if (miktar > 10) {\n    return err({ type: 'StokYetersiz', message: 'Maksimum 10 adet \u00fcr\u00fcn sepete eklenebilir.', sepetId: 'ABC123' });\n  }\n  \/\/ Di\u011fer do\u011frulama veya i\u015flem...\n  return ok(${miktar} adet ${urunId} sepete eklendi.<\/code>);\n}\n\n\/\/ Kullan\u0131m \u00f6rne\u011fi\nconst sonuc = urunGetir(\"404\");\nif (sonuc.isErr()) {\n  const hata = sonuc.error;\n  switch (hata.type) {\n    case 'UrunBulunamadi':\n      console.error(\ud83d\udea8 \u00dcr\u00fcn bulunamad\u0131: ${hata.message} (Zaman: ${hata.timestamp.toLocaleTimeString()})<\/code>);\n      break;\n    case 'GecersizUrunID':\n      console.error(\u26a0\ufe0f Ge\u00e7ersiz \u00fcr\u00fcn ID: ${hata.message}<\/code>);\n      break;\n    default:\n      console.error('Bilinmeyen hata:', hata);\n  }\n}\n\nconst sepetSonuc = sepeteEkle(\"PROD001\", 15);\nsepetSonuc.match(\n  (success) => console.log(success),\n  (error) => {\n    if (error.type === 'StokYetersiz') {\n      console.warn(\ud83d\uded2 Sepet Hatas\u0131: ${error.message} (Sepet ID: ${error.sepetId})<\/code>);\n    } else {\n      console.error('Farkl\u0131 bir sepet hatas\u0131:', error);\n    }\n  }\n);\n    <\/pre>\n
    <\/code><\/p>\n
    Bu \u00f6rnekte, farkl\u0131 hata senaryolar\u0131 i\u00e7in \u00f6zelle\u015ftirilmi\u015f interface'ler (UrunVeriHatasi<\/code>, SepetIslemHatasi<\/code>) ve bunlar\u0131n birle\u015fiminden olu\u015fan bir SistemHatasi<\/code> tipi tan\u0131mlad\u0131k. Bu sayede, hata i\u015fleme s\u0131ras\u0131nda TypeScript'in discriminating union (ayr\u0131\u015ft\u0131r\u0131c\u0131 birle\u015fim) yetene\u011fini kullanarak, hatan\u0131n tipine g\u00f6re farkl\u0131 alanlara g\u00fcvenli bir \u015fekilde eri\u015febiliriz. Bu yakla\u015f\u0131m, hata i\u015fleme kodunuzu hem daha tip g\u00fcvenli hem de daha okunakl\u0131 hale getirir.<\/p>\n
    Performans Optimizasyonu ve Kod Okunabilirli\u011fi<\/h3>\n
    neverthrow<\/code> kullanmak, genellikle performans \u00fczerinde ihmal edilebilir bir etkiye sahiptir. Ancak, \u00e7ok performans kritik bir d\u00f6ng\u00fc i\u00e7inde s\u00fcrekli Result<\/code> nesneleri olu\u015fturup d\u00f6n\u00fc\u015ft\u00fcr\u00fcyorsan\u0131z, bu durum mikrosaniyeler mertebesinde bir yava\u015flamaya neden olabilir. \u00c7o\u011fu uygulama i\u00e7in bu bir sorun te\u015fkil etmez. \u00d6nemli olan, kodun okunabilirli\u011fini ve bak\u0131m kolayl\u0131\u011f\u0131n\u0131 art\u0131rmakt\u0131r. \u0130\u015fte bu konuda dikkat etmeniz gerekenler:<\/p>\n
      \n
    • A\u00e7\u0131k ve Anla\u015f\u0131l\u0131r Hata Mesajlar\u0131:<\/strong> Hata nesnelerinizin kullan\u0131c\u0131ya veya geli\u015ftiriciye anlaml\u0131 bilgi verdi\u011finden emin olun.<\/li>\n
    • Tutarl\u0131 Hata Tipleri:<\/strong> Uygulaman\u0131z genelinde benzer hata senaryolar\u0131 i\u00e7in ayn\u0131 hata tiplerini kullan\u0131n.<\/li>\n
    • Zincirleme Metotlar\u0131 Do\u011fru Kullan\u0131n:<\/strong> map<\/code>, mapErr<\/code>, andThen<\/code> gibi metotlar\u0131, kodun ak\u0131\u015f\u0131n\u0131 net bir \u015fekilde yans\u0131tacak \u015fekilde birle\u015ftirin. Gereksiz veya a\u015f\u0131r\u0131 zincirleme, okunabilirli\u011fi azaltabilir.<\/li>\n
    • match<\/code> veya do<\/code> Bloklar\u0131:<\/strong> Result<\/code>'\u0131n sonucunu ele al\u0131rken, if (result.isOk())<\/code> yerine match<\/code> metodunu veya neverthrow<\/code>'un deneysel do<\/code> bloklar\u0131n\u0131 (TypeScript'in yak\u0131nda gelebilecek do expressions \u00f6zelli\u011fi) kullanmak, kodu daha deklaratif hale getirir.<\/li>\n<\/ul>\n
      \nimport { Result, ok, err, match } from 'neverthrow';\n\nfunction degerIsle(deger: number): Result {\n  if (deger % 2 !== 0) {\n    return err(\"Tek say\u0131 g\u00f6nderilemez.\");\n  }\n  return ok(\u0130\u015flenen de\u011fer: ${deger}<\/code>);\n}\n\nconst islemSonucu = degerIsle(4);\n\n\/\/ match kullan\u0131m\u0131 daha okunakl\u0131d\u0131r\nislemSonucu.match(\n  (basariliDeger) => console.log(Ba\u015far\u0131l\u0131: ${basariliDeger}<\/code>),\n  (hataMesaji) => console.error(Hata: ${hataMesaji}<\/code>)\n);\n    <\/pre>\n
      <\/code><\/p>\n
      \n
      Uzman \u0130pucu: Hata Toplama ve G\u00f6rselle\u015ftirme<\/h3>\n
      \u00d6zellikle form do\u011frulamalar\u0131 gibi birden fazla hata t\u00fcr\u00fcn\u00fcn olu\u015fabilece\u011fi senaryolarda, neverthrow<\/code>'un combine<\/code> veya all<\/code> metotlar\u0131n\u0131 kullanarak t\u00fcm hatalar\u0131 tek bir Err<\/code> i\u00e7inde toplay\u0131n. Daha sonra, bu hata dizisini kullan\u0131c\u0131 aray\u00fcz\u00fcnde (\u00f6rne\u011fin, her alan\u0131n alt\u0131nda ilgili hata mesaj\u0131n\u0131 g\u00f6stererek) g\u00f6rselle\u015ftirebilirsiniz. Bu, kullan\u0131c\u0131 deneyimini \u00f6nemli \u00f6l\u00e7\u00fcde iyile\u015ftirir ve sorun gidermeyi kolayla\u015ft\u0131r\u0131r.<\/p>\n<\/p><\/div>\n
      Mobil Uyumluluk \u0130\u00e7in Genel Notlar: Responsive Tasar\u0131m (Media Query \u00d6rne\u011fi)<\/h3>\n
      neverthrow<\/code> ve byethrow<\/code> k\u00fct\u00fcphaneleri, uygulaman\u0131z\u0131n arka plan mant\u0131\u011f\u0131n\u0131 g\u00fc\u00e7lendirirken, kullan\u0131c\u0131 aray\u00fcz\u00fcn\u00fcn (UI) mobil cihazlarda da sorunsuz \u00e7al\u0131\u015fmas\u0131, modern uygulamalar\u0131n vazge\u00e7ilmez bir par\u00e7as\u0131d\u0131r. Geli\u015ftirdi\u011finiz web tabanl\u0131 uygulamalar\u0131n mobil uyumlu olmas\u0131, geni\u015f bir kullan\u0131c\u0131 kitlesine ula\u015fman\u0131n anahtar\u0131d\u0131r. Bu, genellikle CSS Media Query'ler kullan\u0131larak sa\u011flan\u0131r.<\/p>\n
      \n\n