> ## Documentation Index > Fetch the complete documentation index at: https://docs.befailproof.ai/llms.txt > Use this file to discover all available pages before exploring further. # Test Etme > Birim testleri, uçtan uca testler ve test yardımcıları failproofai iki test paketine sahiptir: **birim testleri** (hızlı, mock'lanmış) ve **uçtan uca testler** (gerçek alt işlem çağrıları). *** ## Test Çalıştırma ```bash theme={null} # Tüm birim testlerini bir kez çalıştır bun run test:run # Birim testlerini izleme modunda çalıştır bun run test # E2E testlerini çalıştır (kurulum gerektirir - aşağıya bakın) bun run test:e2e # Derleme yapmadan tip kontrolü yap bunx tsc --noEmit # Lint bun run lint ``` *** ## Birim Testleri Birim testleri `__tests__/` dizininde bulunur ve [Vitest](https://vitest.dev) ile `jsdom` kullanır. ```text theme={null} __tests__/ hooks/ builtin-policies.test.ts # Her yerleşik için politika mantığı hooks-config.test.ts # Config yükleme ve kapsam birleştirme policy-evaluator.test.ts # Param enjeksiyonu ve değerlendirme sırası custom-hooks-registry.test.ts # globalThis kayıt defteri ekle/al/temizle custom-hooks-loader.test.ts # ESM yükleyicisi, geçişli içe aktarımlar, hata işleme manager.test.ts # kurulum/kaldırma/listeleme işlemleri components/ sessions-list.test.tsx # Oturum listesi bileşeni project-list.test.tsx # Proje listesi bileşeni ... lib/ logger.test.ts paths.test.ts date-filters.test.ts telemetry.test.ts ... actions/ get-hooks-config.test.ts get-hook-activity.test.ts ... contexts/ ThemeContext.test.tsx AutoRefreshContext.test.tsx ``` ### Politika birim testi yazma ```typescript theme={null} import { describe, it, expect, beforeEach } from "vitest"; import { getBuiltinPolicies } from "../../src/hooks/builtin-policies"; import { allow, deny } from "../../src/hooks/policy-types"; describe("block-sudo", () => { const policy = getBuiltinPolicies().find((p) => p.name === "block-sudo")!; it("denies sudo commands", () => { const ctx = { eventType: "PreToolUse" as const, payload: {}, toolName: "Bash", toolInput: { command: "sudo apt install nodejs" }, params: { allowPatterns: [] }, }; expect(policy.fn(ctx)).toEqual(deny("sudo command blocked by failproofai")); }); it("allows non-sudo commands", () => { const ctx = { eventType: "PreToolUse" as const, payload: {}, toolName: "Bash", toolInput: { command: "ls -la" }, params: { allowPatterns: [] }, }; expect(policy.fn(ctx)).toEqual(allow()); }); it("allows patterns in allowPatterns", () => { const ctx = { eventType: "PreToolUse" as const, payload: {}, toolName: "Bash", toolInput: { command: "sudo systemctl status nginx" }, params: { allowPatterns: ["sudo systemctl status"] }, }; expect(policy.fn(ctx)).toEqual(allow()); }); }); ``` *** ## Uçtan Uca Testler E2E testleri gerçek `failproofai` ikili dosyasını bir alt işlem olarak çağırır, stdin'e JSON yükü aktarır ve stdout çıkışı ile çıkış kodunu doğrular. Bu, Claude Code'un kullandığı tam entegrasyon yolunu test eder. ### Kurulum E2E testleri ikili dosyayı doğrudan depo kaynak kodundan çalıştırır. İlk çalıştırmadan önce, özel hook dosyalarının `'failproofai'`'den içe aktarırken kullandığı CJS paketini derleyin: ```bash theme={null} bun build src/index.ts --outdir dist --target node --format cjs ``` Ardından testleri çalıştırın: ```bash theme={null} bun run test:e2e ``` Genel hook API'sini değiştirdiğinizde (`src/hooks/custom-hooks-registry.ts`, `src/hooks/policy-helpers.ts` veya `src/hooks/policy-types.ts`) `dist/` dizinini yeniden derleyin. ### E2E test yapısı ```text theme={null} __tests__/e2e/ helpers/ hook-runner.ts # İkiliyi çağır, payload JSON'ı aktarıl, çıkış kodu + stdout + stderr yakala fixture-env.ts # Config dosyaları olan test başına izole geçici dizinler payloads.ts # Her olay türü için Claude-doğru payload fabrikaları hooks/ builtin-policies.e2e.test.ts # Her yerleşik politika gerçek alt işlemle custom-hooks.e2e.test.ts # Özel hook yükleme ve değerlendirme config-scopes.e2e.test.ts # Proje/yerel/genel arasında config birleştirme policy-params.e2e.test.ts # Her parametreli politika için parametre enjeksiyonu ``` ### E2E yardımcılarını kullanma **`FixtureEnv`** - test başına izole ortam: ```typescript theme={null} import { createFixtureEnv } from "../helpers/fixture-env"; const env = createFixtureEnv(); // env.cwd - geçici dir; .failproofai/policies-config.json'u almak için payload.cwd olarak geçir // env.home - izole ev dizini; gerçek ~/.failproofai sızıntısı yoktur env.writeConfig({ enabledPolicies: ["block-sudo"], policyParams: { "block-sudo": { allowPatterns: ["sudo systemctl status"] }, }, }); ``` `createFixtureEnv()` `afterEach` temizliğini otomatik olarak kaydeder. **`runHook`** - ikiliyi çağır: ```typescript theme={null} import { runHook } from "../helpers/hook-runner"; import { Payloads } from "../helpers/payloads"; const result = await runHook( "PreToolUse", Payloads.preToolUse.bash("sudo apt install nodejs", env.cwd), { homeDir: env.home } ); expect(result.exitCode).toBe(0); expect(result.parsed?.hookSpecificOutput?.permissionDecision).toBe("deny"); ``` **`Payloads`** - hazır payload fabrikaları: ```typescript theme={null} Payloads.preToolUse.bash(command, cwd) Payloads.preToolUse.write(filePath, content, cwd) Payloads.preToolUse.read(filePath, cwd) Payloads.postToolUse.bash(command, output, cwd) Payloads.postToolUse.read(filePath, content, cwd) Payloads.notification(message, cwd) Payloads.stop(cwd) ``` ### E2E testi yazma ```typescript theme={null} import { describe, it, expect } from "vitest"; import { createFixtureEnv } from "../helpers/fixture-env"; import { runHook } from "../helpers/hook-runner"; import { Payloads } from "../helpers/payloads"; describe("block-rm-rf (E2E)", () => { it("denies rm -rf", async () => { const env = createFixtureEnv(); env.writeConfig({ enabledPolicies: ["block-rm-rf"] }); const result = await runHook( "PreToolUse", Payloads.preToolUse.bash("rm -rf /", env.cwd), { homeDir: env.home } ); expect(result.exitCode).toBe(0); expect(result.parsed?.hookSpecificOutput?.permissionDecision).toBe("deny"); }); it("allows non-recursive rm", async () => { const env = createFixtureEnv(); env.writeConfig({ enabledPolicies: ["block-rm-rf"] }); const result = await runHook( "PreToolUse", Payloads.preToolUse.bash("rm /tmp/file.txt", env.cwd), { homeDir: env.home } ); expect(result.exitCode).toBe(0); expect(result.stdout).toBe(""); // izin ver → boş stdout }); }); ``` ### E2E yanıt şekilleri | Karar | Çıkış kodu | stdout | | -------------------- | ---------- | --------------------------------------------------------------------------------------- | | `PreToolUse` reddet | `0` | `{"hookSpecificOutput":{"permissionDecision":"deny","permissionDecisionReason":"..."}}` | | `PostToolUse` reddet | `0` | `{"hookSpecificOutput":{"additionalContext":"Blocked ... because: ..."}}` | | Talimat (Stop değil) | `0` | `{"hookSpecificOutput":{"additionalContext":"Instruction from failproofai: ..."}}` | | Stop talimatı | `2` | boş stdout; stderr'de neden | | İzin ver | `0` | boş dize | ### Vitest yapılandırması E2E testleri `vitest.config.e2e.mts` kullanır: * `environment: "node"` - tarayıcı globals'ı gerekli değil * `pool: "forks"` - gerçek işlem izolasyonu (testler alt işlemleri çağırır) * `testTimeout: 20_000` - test başına 20s (ikili başlatma + hook değerlendirmesi) `forks` havuzu önemlidir: iş parçacığı tabanlı çalışanlar `globalThis`'i paylaşır, bu da alt işlem çağıran testleri etkileyebilir. İşlem tabanlı forks bunu önler. *** ## CI Tam CI çalıştırması (`bun run lint && bunx tsc --noEmit && bun run test:run && bun run build`) birleştirmeden önce başarılı olması gerekir. E2E paketi paralel olarak ayrı bir CI işi olarak çalışır. Tam ön birleştirme kontrol listesi için [Contributing](../CONTRIBUTING.md) bölümüne bakın.