---
paths:
  - "VideoDownloader.Tests/**"
---

# 테스트 영역 규칙

## 배치

`VideoDownloader.Tests/<영역>/<대상>Tests.cs` — 영역은
`Browser` · `E2E` · `Infrastructure` · `Mobile` · `Platform` · `Server`.
새 영역을 만들기 전에 기존 영역에 맞는지 먼저 본다.

## 격리 (필수)

사용자 데이터 경로를 건드리는 테스트는 `VD_DATA_DIR` 을 임시 디렉터리로 지정하고
끝나면 `null` 로 되돌린다. `E2E/MainWindowSmokeE2ETests.cs:17` 이 기준 패턴이다.
이걸 빼면 테스트가 실사용자의 설정·세션·프로필을 덮어쓴다.

## WPF 테스트

테스트 프로세스에는 `App.xaml` 리소스가 없다. WPF 요소를 만드는 테스트는
`Infrastructure/WpfTestApp.Ensure(dispatcher)` 를 먼저 호출해 테마 사전을 로드한다.
직접 `new Application()` 을 만들지 않는다.

## 금지

- 통과시키려고 테스트를 **삭제하거나 `Skip` 처리하지 않는다.** 회귀를 숨기는 것이다.
- 실제 네트워크에 의존하는 단정을 새로 만들지 않는다. 외부 사이트가 바뀌면 무작위로 깨진다.
  (`Cli` 의 `--dashparse` 같은 수동 검증 도구는 예외 — 테스트가 아니다.)
- 시간·순서에 의존하는 `Thread.Sleep` 기반 단정을 쓰지 않는다.

## 알려진 경고

이 프로젝트에 남아 있는 경고: CS8602(null 역참조) 몇 건, xUnit1031(블로킹 대기),
xUnit2013(`Assert.Equal` 로 개수 확인). **개수를 늘리지 않는다.**
새 테스트에서는 `Assert.Single`/`Assert.Empty` 와 `async` 대기를 쓴다.

## 실행

```powershell
dotnet test VideoDownloader.Tests                                        # 전체 (~13초)
dotnet test VideoDownloader.Tests --filter "FullyQualifiedName~<이름>"   # 단건
```