Kullanıcı tanımlı tip guard nedir?

Question

Accepted Answer

Bir **kullanıcı tanımlı tip guard**, dönüş tipi **tip yüklem** (`x is T`) olan bir fonksiyondur. `true` döndüğünde, derleyici çağıran koddaki argümanı `T` ile daraltır — özel çalışma zamanı denetimlerini kapsüllemenizi sağlar.

```ts
interface Cat { meow(): void; }
interface Dog { bark(): void; }

// the magic is the return type `pet is Cat`, not just `boolean`
function isCat(pet: Cat | Dog): pet is Cat {
  return "meow" in pet;
}

function speak(pet: Cat | Dog) {
  if (isCat(pet)) {
    pet.meow(); // ✅ narrowed to Cat
  } else {
    pet.bark(); // ✅ narrowed to Dog
  }
}
```

`pet is Cat` yüklemi olmadan, `isCat` `boolean` döndürüyorsa `pet`'i daraltmaz — derleyici `if` içinde hâlâ `Cat | Dog` görür. Yüklem, bunu öğreten şeydir.

## Bilinmeyen dış verileri doğrulama

```ts
interface User { id: number; name: string; }

function isUser(x: unknown): x is User {
  return (
    typeof x === "object" && x !== null &&
    typeof (x as any).id === "number" &&
    typeof (x as any).name === "string"
  );
}

const data: unknown = await res.json();
if (isUser(data)) data.name; // ✅ safely typed as User
```

## Dikkat

Derleyici **güvenir** yükleminize — eğer gövdenin mantığı yanlışsa, güvenli olmayan bir daraltma elde edersiniz. Karmaşık şekiller için, bir şema doğrulayıcısı (zod) sizin için doğru guard'lar oluşturur.

## Neden önemli

Tip guard'lar, keyfi çalışma zamanı denetimlerini yeniden kullanılabilir daraltma fonksiyonlarına dönüştürmenizi sağlar — `unknown` verileri API/sınırlarında doğrulamak ve bir birlik üyelerini ayırt etmek için basit bir `typeof`/`in` denetimi yalnız başına yeterli olmadığında önemlidir.