React Native 테스트 계층: 어떤 실패를 어디에서 막는가

막으려는 실패                         가장 작은 충분한 시작점                 필요한 실행 위치
금액 계산·상태 전이                   JavaScript Jest                         host
네이티브 모듈·권한 콜백 연결          Android 계측 / iOS 네이티브 통합          Emulator·Simulator 또는 기기
설치된 앱의 핵심 사용자 흐름          E2E                                    Emulator·Simulator 또는 기기
실제 카메라·센서·생체 기능·성능       native integration 또는 E2E            physical device

npx @react-native-community/[email protected] init TestLayerApp \
  --version 0.86.2 \
  --skip-install
cd TestLayerApp
npm install

TestLayerApp/
├─ test-ownership.ts
└─ __tests__/
   └─ test-ownership.test.ts

const USE_TEST_MATRIX = false
 
export type RiskId =
  | 'amount-rounding'
  | 'permission-callback-contract'
  | 'real-camera-capture'
 
export type CheckKind =
  | 'javascript-jest'
  | 'native-integration'
  | 'user-flow-e2e'
 
export type Destination =
  | 'host'
  | 'android-emulator'
  | 'ios-simulator'
  | 'physical-device'
 
export type EvidenceCheck = {
  check: CheckKind
  destinations: Destination[]
}
 
export type TestPlan = {
  evidence: EvidenceCheck[]
}
 
const PLAN_BY_RISK: Record<RiskId, TestPlan> = {
  'amount-rounding': {
    evidence: [
      { check: 'javascript-jest', destinations: ['host'] },
    ],
  },
  'permission-callback-contract': {
    evidence: [
      { check: 'javascript-jest', destinations: ['host'] },
      {
        check: 'native-integration',
        destinations: ['android-emulator', 'ios-simulator'],
      },
    ],
  },
  'real-camera-capture': {
    evidence: [
      { check: 'native-integration', destinations: ['physical-device'] },
      { check: 'user-flow-e2e', destinations: ['physical-device'] },
    ],
  },
}
 
export function planEvidence(riskId: RiskId): TestPlan {
  if (!USE_TEST_MATRIX) {
    return {
      evidence: [
        { check: 'javascript-jest', destinations: ['host'] },
      ],
    }
  }
 
  return PLAN_BY_RISK[riskId]
}

import { planEvidence, type RiskId, type TestPlan } from '../test-ownership'
 
const CASES: Array<{
  name: string
  riskId: RiskId
  expected: TestPlan
}> = [
  {
    name: '금액 반올림',
    riskId: 'amount-rounding',
    expected: {
      evidence: [
        { check: 'javascript-jest', destinations: ['host'] },
      ],
    },
  },
  {
    name: '권한 callback contract',
    riskId: 'permission-callback-contract',
    expected: {
      evidence: [
        { check: 'javascript-jest', destinations: ['host'] },
        {
          check: 'native-integration',
          destinations: ['android-emulator', 'ios-simulator'],
        },
      ],
    },
  },
  {
    name: '실제 카메라 촬영',
    riskId: 'real-camera-capture',
    expected: {
      evidence: [
        { check: 'native-integration', destinations: ['physical-device'] },
        { check: 'user-flow-e2e', destinations: ['physical-device'] },
      ],
    },
  },
]
 
describe.each(CASES)('$name', ({ riskId, expected }) => {
  test('막으려는 실패를 볼 수 있는 범위와 실행 위치를 보존한다', () => {
    expect(planEvidence(riskId)).toEqual(expected)
  })
})

npm test -- --runInBand __tests__/test-ownership.test.ts

Test Suites: 1 failed, 1 total
Tests:       2 failed, 1 passed, 3 total

cd android
./gradlew connectedDebugAndroidTest
cd ..

앱 시작 → 촬영 열기 → 권한 선택 → 영수증 촬영 → 금액 검토 화면

build            JavaScript bundle ID, Android/iOS build ID와 설정
scope            unit / integration / E2E 중 실제 실행한 테스트 범위
destination      Emulator / Simulator / physical device 중 실행 목적지와 모델·운영체제
dependencies     fake·mock으로 바꾼 경계와 실제로 사용한 서버·SDK
result           입력, 기대 결과, 실제 결과, screenshot·video·test result 위치
limits           실행하지 않은 플랫폼·권한·기기 능력

const USE_TEST_MATRIX = true

npm test -- --runInBand __tests__/test-ownership.test.ts

PASS __tests__/test-ownership.test.ts
Test Suites: 1 passed, 1 total
Tests:       3 passed, 3 total

금액 반올림             JavaScript Jest → host
권한 콜백 계약          JavaScript Jest → host
                        native integration → Android Emulator + iOS Simulator
실제 카메라 촬영        native integration → physical device
                        user-flow E2E → physical device

위험                  실패했을 때 사용자 영향과 재현 입력
JavaScript            pure logic·state·component 결과와 host Jest
Android native        실제 모듈·권한 콜백·Activity 경계와 계측 test 결과
iOS native            플랫폼 연결·콜백 또는 UI 사용자 흐름과 Xcode test 결과
E2E                   설치 build의 핵심 사용자 흐름과 실패 screenshot·video
physical device       기기 모델·운영체제·권한·능력·build와 실제 결과
대역                  fake·mock으로 바꾼 경계와 그 때문에 증명하지 못한 범위
실행 주기             commit / pull request / 매일 밤 자동 실행 / 공개 후보 build 검증

문제       mocked native module을 쓴 Jest 통과를 전체 촬영 검증으로 확대
실패       금액 규칙만 확인하고 네이티브 콜백·실제 카메라 능력은 실행하지 않음
JavaScript 순수 로직·상태·component 계약 → host Jest
Native     Android 계측 / Xcode unit·integration·UI → Emulator·Simulator 또는 기기
E2E        설치된 앱의 핵심 사용자 흐름 → 공개 설정에 가까운 build와 실행 목적지
실기기     테스트 범위가 아니라 실제 하드웨어·성능을 보존하는 실행 목적지
교정       위험마다 가장 작은 충분한 범위와 필요한 실행 목적지를 함께 기록
경계       fixture의 matrix 통과는 제품 native test와 실기기 결과를 증명하지 않음