For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /ko/docs/web/testing.md (or send Accept: text/markdown).
테스트 전략
결정적, 브라우저, 데이터베이스, 프로바이더 검사가 각각 무엇을 확립하는지 이해하세요.
설치 및 설정
어떤 단계를 시작하기 전에 시작하기 전에 및 터미널 기본 사항을 읽어보세요. 이 지침에서는 VS Code에서 전체 supastack 단일 저장소를 열었다고 가정합니다. 해당 루트 package.json은 저장소 루트를 표시합니다. pnpm 명령에서 작업 영역 패키지는 앱 또는 공유 코드 폴더입니다. 제품에서 작업공간은 팀의 데이터 컨테이너이자 보안 경계입니다. corepack pnpm --filter ... 명령이 해당 루트에서 실행되는 동안 monorepo에서 하나의 패키지를 선택합니다. 동기화된 모바일 또는 데스크톱 폴더만 열었다면 웹 백엔드, Docker 설정 또는 루트 스크립트가 포함되지 않습니다. 이 모노 저장소 또는 연결 가능한 호스팅 서버에서 백엔드를 실행하고 플랫폼 폴더의 자체 스크립트를 사용하세요. 환경 변수는 로컬 .env 파일이나 호스팅 대시보드에 저장된 명명된 설정입니다. 관련 앱을 변경한 후 다시 시작하고, NEXT_PUBLIC_ 및 EXPO_PUBLIC_ 값에서 서버 비밀을 유지하세요.
1. repository-root package.json을 열어 확인 명령을 확인하세요.
2. 해당 루트 폴더에서 자동화된 단위 테스트를 위해 corepack pnpm test를 실행한 다음 웹 TypeScript 검사를 위해 corepack pnpm --filter @supastack/web typecheck를 실행합니다.
3. 브라우저 동작을 확인하려면 웹 앱을 시작하고 corepack pnpm test:e2e를 실행하세요. 예상: 각 명령은 자체 결과를 보고합니다. 단위 테스트는 실제 데이터베이스, 결제 서비스 제공업체, 이메일 서비스 또는 전화가 작동하는지 입증하지 않습니다.
기본 테스트 스위트는 결정적 fake/로컬 어댑터를 사용합니다. 브라우저 테스트는 사용자 상호작용을 커버하고, 데이터베이스 수용과 외부 프로바이더 스모크는 별도의 게이트입니다. 범위를 넓히기 전에 변경된 동작과 관련된 검사를 실행하세요.
corepack pnpm test
corepack pnpm check
corepack pnpm build
corepack pnpm test:e2e
corepack pnpm test:e2e:production복사 명령
설명을 따라 명령이 실행되는 폴더를 확인하세요. 두 개의 터미널에 레이블이 지정되어 있으면 두 개의 터미널 창을 열고 두 번째 명령을 사용하는 동안 첫 번째 명령을 계속 실행하세요.
corepack pnpm test
corepack pnpm --filter @supastack/web typecheck
corepack pnpm test:e2e구현 워크플로
동작 변경에는 먼저 실패하는 수용 테스트를 작성하세요. 성공적인 액세스와 거부된 익명 및 워크스페이스 간 요청을 짝지으세요. 폼과 작업 플로에서는 해피 패스를 넘어 로딩, 오류, 복구를 검증하세요.
가로챈 브라우저 응답은 인터페이스가 그 픽스처에 응답함을 증명합니다. 인증 영속화, 결제 처리, 프로바이더 전송, 물리적 디바이스 콜백을 증명하지는 않습니다.
검증 및 문제 해결
데이터베이스 테스트에서 건너뛴 것으로 나타나면 데이터베이스 적용 범위를 보고하기 전에 격리된 테스트 데이터베이스를 설정하세요. 웹 탭이 포트 3001에 있으면 이는 별도의 apps/docs 서버입니다. 키트 웹 앱은 포트 3000에서 시작됩니다. Playwright가 첫 번째 Windows 실행에서 실패하면 브라우저 설치를 마치고 실패한 명령을 다시 실행하세요. 문제를 해결하기 위해 시스템 전체 보안을 끄지 마십시오.
데이터베이스 게이트 테스트가 건너뛰어지면 그 게이트가 통과했다고 주장하기 전에 격리된 테스트 데이터베이스를 구성하세요. 브라우저 러너가 통과하는 어설션을 출력하지만 teardown에서 멈추면 두 사실을 모두 보고하세요. 멈춘 프로세스는 깨끗한 성공 명령이 아닙니다.
Windows에서는 Defender가 새로 설치된 Playwright 브라우저 또는 종속성을 검사하는 동안 초기 브라우저 실행 시간이 초과될 수 있습니다. 설치가 완료되면 corepack pnpm test:e2e 또는 corepack pnpm test:e2e:production을 사용하여 실패한 제품군을 다시 실행하고, 다시 실패하면 해당 추적 및 Defender Protection History를 검사합니다. 시스템 전체 보호를 활성화된 상태로 둡니다.
로컬 브라우저 제품군은 포트 3100을 소유하고 있으며 이미 그곳에서 수신 중인 프로세스를 재사용하는 것을 거부합니다. 다른 앱이 3100을 소유한 경우 corepack pnpm test:e2e 이전에 PLAYWRIGHT_PORT를 사용 가능한 포트로 설정합니다. 이렇게 하면 테스트가 자동으로 다른 프로젝트를 대상으로 하는 것을 방지할 수 있습니다.