# React Doctor Sitemi 52 Puanla Kritik Buldu: Bulgu Bir Hipotezdir

> React Doctor sitemi 52 puanla kritik buldu. Bulguların neredeyse yarısını düzeltmedim; çünkü bulgu bir hipotez, düzeltme bazen zararlı.

Source: https://omergulcicek.com/blog/react-doctor-bulgulari

[React Doctor](https://github.com/millionco/react-doctor), React kodunu tarayıp state, effect, performans, mimari, güvenlik ve erişilebilirlik sorunlarını raporlayan bir araç.[^rd-readme] Kurulum gerektirmiyor; proje klasöründe `npx react-doctor@latest` komutunu çalıştırmak yetiyor.[^rd-readme]

Bu komutu kendi sitemde çalıştırdım. Sonuç: 100 üzerinden 52, etiket "Critical". 344 dosyada 29 bulgu vardı: 12 hata, 17 uyarı.

Düzeltmelerden sonra puan 76'ya çıktı ve hata kalmadı. Ama asıl öğrendiğim puan değildi: bulguların neredeyse yarısını düzeltmedim, çünkü düzeltmek ya gereksizdi ya da zararlıydı.

![Puan 52'den 76'ya çıkıyor; solda düzeltilen bulgular, sağda sorgulanıp bırakılanlar](https://omergulcicek.com/blog/2026/11-18/react-doctor-bulgulari.webp)

## Önce Gürültüyü Kes

Bulguların bir kısmı kodumla ilgili değildi. Biri `pnpm build` çıktısı olan `.output` klasöründen geliyordu, birkaçı da shadcn/ui'ın ürettiği `components/ui` dosyalarından.

İkisini React Doctor'un config dosyasıyla taramadan çıkardım:

```json
{
  "ignore": {
    "files": [".output/**", "src/components/ui/**"]
  }
}
```

Bir tarama aracını ilk çalıştırdığında yapılacak ilk iş bu: üretilen ve dışarıdan gelen dosyaları ayıklamak. Yoksa gerçek bulgular gürültünün içinde kaybolur. Kendi koduma ait bir bulguyu ise config'le susturmadım; onun için ya kodu düzelttim ya da gerekçesini yazdım.

## Puanı Hook'lar Taşıdı

En büyük sıçrama tek bir düzeltmeden geldi. Arama bileşeninde bir hook'u bileşenin içinde ok fonksiyonu olarak tanımlayıp iki kez çağırıyordum:

```tsx
function SiteSearch() {
  const usePostsWhenOpen = (category) => useQuery(/* ... */);
  // ...
}
```

Kod çalışıyordu, çünkü çağrı sırası hiç değişmiyordu. Ama React'in kuralı açık: hook'lar iç içe fonksiyonlarda çağrılmaz, yalnızca bileşenin ya da custom hook'un en üst seviyesinde çağrılır.[^hooks] React Compiler da kuralı çiğneyebilecek bir kod gördüğünde davranışı bozma riskine girmek yerine o kodu optimize etmeden geçiyor.[^compiler] Yani bileşen otomatik memoization'dan sessizce mahrum kalıyordu.

Hook'u aynı dosyada modül seviyesine taşıdım; davranış aynı kaldı. Puan 56'dan 75'e çıktı ve üç hata birden kalktı.

Son düzeltme de görünmeyen bir tuzaktı. TanStack Router route seçeneklerinin sırasından tip çıkarıyor: `head`, `loader`'dan sonra gelmeli.[^tanstack-order] Yedi route dosyasında `head` en baştaydı. Bugün hiçbiri loader verisini kullanmadığı için sorun çıkmamıştı ama kullansaydı tipler yanlış çıkacaktı. Sırayı düzeltince hata sayısı sıfıra indi. Aynı hata tekrarlanmasın diye hem bu siteye hem de [ViraStack Start](https://virastack.com/tr/start)'ın TanStack şablonlarına `@tanstack/eslint-plugin-router` paketini ekledim.[^router-plugin] Paketin `create-route-property-order` kuralı sırayı lint sırasında denetliyor ve `--fix` ile kendisi düzeltiyor.[^router-rule]

## Önerilen Düzeltme Bazen Zararlı

Kalan bulguların çoğunda araç, kodun bağlamını göremiyordu. Örneğin tarih biçimlendiren bir nesneyi dosyanın en üstüne taşımamı önerdi; iki dilli bir sitede bu, bir ziyaretçinin dilinin diğerine geçmesine yol açabilirdi. Başka bir bulguda istediği kontrol zaten vardı, yalnızca başka bir fonksiyonun içindeydi.

Sonuçta 13 farklı sorunun 7'sini düzelttim, 6'sını gerekçesini yazarak bıraktım.

## Bulgu Bir Hipotezdir

Bunu en iyi aracın kendisi söylüyor. React Doctor'un agent'lar için yazdığı yönergenin ilk cümlesi, bulguları başlangıç hipotezi olarak ele almayı ve her birini onaylamadan ya da susturmadan önce ilgili kodu okumayı istiyor.[^rd-guidance] Aynı yönerge, dosyadan kanıt olmadan bir bulguyu susturmamayı da söylüyor.[^rd-guidance]

Bu taramayı bir agent'la birlikte yaptım ve her bulguyu tek tek tartıştık. Agent'a "hepsini düzelt" deseydim puan belki daha da yükselirdi ama sitenin çalışması bozulurdu.

Amaç React Doctor'da 100 puanı görmek değil; bu bir Lighthouse skoru değil. Amaç, gözden kaçan şeyleri React Doctor'un bulması, bizim her bulguyu sorgulamamız ve gerekiyorsa düzeltmemiz. Bazen sorgunun cevabı "burada sorun yok" çıkıyor ve o da bir sonuç.

[^rd-readme]: [React Doctor: README](https://github.com/millionco/react-doctor)
[^hooks]: [React: Rules of Hooks](https://react.dev/reference/rules/rules-of-hooks)
[^compiler]: [React: Debugging and Troubleshooting React Compiler](https://react.dev/learn/react-compiler/debugging)
[^tanstack-order]: [TanStack Router: Ensure correct order of inference sensitive properties](https://tanstack.com/router/latest/docs/eslint/create-route-property-order)
[^rd-guidance]: [React Doctor: render-agent-guidance.ts](https://github.com/millionco/react-doctor/blob/main/packages/react-doctor/src/cli/utils/render-agent-guidance.ts)
[^router-plugin]: [TanStack Router: ESLint Plugin Router](https://tanstack.com/router/latest/docs/eslint/eslint-plugin-router)
[^router-rule]: [TanStack Router: create-route-property-order kaynak kodu](https://github.com/TanStack/router/blob/main/packages/eslint-plugin-router/src/rules/create-route-property-order/create-route-property-order.rule.ts)
