Test yazımında assertionlar nedir?

Question

Accepted Answer

**Assertionlar**, bir testte **bir koşulun doğru olup olmadığını kontrol eden** ifadelerdir — gerçek sonucun beklenen sonuçla eşleşip eşleşmediğini doğrular. Testlerin geçip geçmemeyi belirleyen temel mekanizmadır: bir assertion başarısız olursa, test başarısız olur.

## Assertionlar ne yapar

```text
An ASSERTION checks that something is as expected:
  → "assert that the actual value EQUALS the expected value"
  → if TRUE → the assertion passes; if FALSE → the assertion FAILS → the TEST FAILS
→ Assertions are how a test VERIFIES behavior (the "check" part of a test).
```

## Yaygın assertion türleri

```js
// equality
expect(result).toBe(5);                  // strict equality
expect(obj).toEqual({ name: 'Ann' });    // deep/value equality (objects)

// truthiness / null
expect(value).toBeTruthy();
expect(value).toBeNull();
expect(value).toBeDefined();

// comparisons
expect(count).toBeGreaterThan(0);
expect(price).toBeLessThanOrEqual(100);

// collections / strings
expect(array).toContain('item');
expect(array).toHaveLength(3);
expect(text).toMatch(/pattern/);          // regex

// errors
expect(() => risky()).toThrow();          // expect a function to throw

// negation
expect(value).not.toBe(null);
```

## İyi assertionlar

```text
✓ Assert the SPECIFIC expected outcome (clear what's being checked)
✓ Use the RIGHT matcher (toBe vs toEqual; specific > generic)
✓ Clear FAILURE messages (good assertions/matchers explain what failed)
✓ Don't over-assert (test one behavior) or under-assert (verify the actual result)
```

## Neden önemli

Asertionları anlamak temeldir çünkü bunlar **testlerin davranışı doğrulamasının temel mekanizması** — geçip geçmemeyi belirler — bu nedenle herhangi bir test yazma için gerekli, zorunlu bilgidir.

Bir assertion **bir koşulun doğru olup olmadığını kontrol eder** (tipik olarak gerçek sonucun beklenen sonuçla eşleşip eşleşmediği), ve bu bir testin "doğrulama" kısmıdır: eğer bir assertion kontrolü geçerse durum doğrudur ve başarısız olursa test başarısız olur.

Asertionlar olmadan, bir test aslında hiçbir şeyi doğrulamaz — bu nedenle bunları anlamak anlamlı testler yazmanın temelini oluşturur.

**Yaygın assertion türlerini** — eşitlik (katı `toBe` vs nesne için derin/değer `toEqual`, önemli bir ayrım), doğruluk ve null kontrolleri, karşılaştırmalar, koleksiyon ve string kontrolleri, error assertionları (bir fonksiyonun throw atıp atmadığını doğrulama) ve negasyon — anlamak, bir testin ne doğrulaması gerektiğini ifade etmek için gerekli pratik bilgidir.

**İyi assertion uygulamalarını** — spesifik beklenen sonucu doğrulama (hangi kontrol yapıldığı hakkında açık), doğru matcher'ı kullanma (örneğin nesne karşılaştırması için `toEqual`, `toBe` değil), açık hata mesajları sağlama (başarısız bir test ne yanlış giddiğini açıklar) ve assertionları dengeleme (bir davranışı test etme, ancak gerçek sonucu doğrulama) — anlamak, açık ve etkili testler yazmanın yansımasıdır.

Asertionlar her testin davranışı doğrulayan yolu olduğu için (bir testi anlamlı kılan temel kontrol) ve bunları — türleri, doğru matcher'ları ve iyi uygulamaları — anlamak herhangi bir şeyi gerçekten doğrulayan bir test yazma için gerekli olduğu için, assertionları anlamak gerekli, temel test bilgisidir — testlerin temel yapı taşı, beklenen davranışı ifade etme ve doğrulama için gerekli ve doğruluğu anlamlı biçimde kontrol eden testler yazma için temeldir, test yazanlar için temel yetkinliktir.