React Doctor, React kodunu tarayıp state, effect, performans, mimari, güvenlik ve erişilebilirlik sorunlarını raporlayan bir araç.1 Kurulum gerektirmiyor; proje klasöründe npx react-doctor@latest komutunu çalıştırmak yetiyor.1
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ı.

Ö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:
{
"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:
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.2 React Compiler da kuralı çiğneyebilecek bir kod gördüğünde davranışı bozma riskine girmek yerine o kodu optimize etmeden geçiyor.3 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.4 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'ın TanStack şablonlarına @tanstack/eslint-plugin-router paketini ekledim.5 Paketin create-route-property-order kuralı sırayı lint sırasında denetliyor ve --fix ile kendisi düzeltiyor.6
Ö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.7 Aynı yönerge, dosyadan kanıt olmadan bir bulguyu susturmamayı da söylüyor.7
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ç.