도구 소개
샘플 응답을 어설션으로 바꾸는 일은 기계적인 작업입니다. JSON을 훑으며 필드마다 기대값을 하나씩 작성하고, 대시나 점이 들어간 키의 접근 문법을 맞추고, null과 배열에 맞는 매처를 써야 합니다. 이 빌더는 응답의 모든 필드를 나열하고(배열은 길이 검사용으로 한 번, 그리고 첫 번째 요소를 통해 하위 필드까지), 중요한 필드를 선택하면 코드를 생성합니다. Playwright(await expect(response).toBeOK()와 expect(body.user.id).toBe(42)), Postman(pm.test와 pm.expect), REST Assured(then().statusCode(200).body("user.id", equalTo(42))), Cypress(cy.request와 .its())를 지원합니다. 안정적인 필드는 정확한 값으로, ID나 타임스탬프처럼 실행마다 바뀌는 값은 타입만 검사하도록 선택하세요.
사용 방법
- 샘플 JSON 응답을 붙여 넣고 메서드, URL, 기대 상태 코드를 설정하세요.
- 어설션할 필드를 선택하세요. 기본으로 처음 10개가 선택되며, “All”(전체)이나 “None”(없음)으로 빠르게 바꿀 수 있습니다.
- 프레임워크와 정확한 값 또는 타입 전용 어설션을 고른 뒤 생성된 코드를 테스트에 복사하세요.
API 어설션 빌더 자주 묻는 질문
정확한 값을 어설션해야 하나요, 타입만 검사해야 하나요?
테스트가 제어하거나 안정적인 필드(status, role, currency)는 정확한 값으로 어설션하세요. 생성되거나 시간에 따라 바뀌는 값(ID, 타임스탬프, 토큰)은 타입만 검사하세요. 그렇지 않으면 실행할 때마다 테스트가 깨집니다.
REST Assured에서 소수를 12.5f로 비교하는 이유는 무엇인가요?
REST Assured의 JsonPath는 기본적으로 소수를 Float로 반환하며, Hamcrest의 equalTo(12.5)에 Double을 넣으면 Float와 일치하지 않습니다. 프로젝트에서 JsonPathConfig를 Double이나 BigDecimal을 반환하도록 설정했다면 리터럴을 그에 맞게 바꾸세요.
Cypress 코드에 failOnStatusCode: false가 추가되는 이유는 무엇인가요?
cy.request는 기본적으로 4xx와 5xx 응답에서 테스트를 실패시킵니다. 오류 상태를 기대하는 경우 이 옵션을 쓰면 요청이 완료되어 상태 코드와 바디를 어설션할 수 있습니다.