목 스크립트

목 스크립트를 사용하면 요청 매개변수와 응답 데이터 간의 논리적 관계가 있는 지능형 목 응답을 만들 수 있습니다. 이 기능은 문맥적 정확성을 유지하거나 요청 값을 반영하는 목 데이터가 필요할 때 필수적입니다.

사용 사례

목 스크립트는 논리적 데이터 관계가 필요한 시나리오에 적합합니다.

일반적인 예시

요청된 ID와 일치하는 사용자 ID를 응답으로 반환합니다(예: 요청 ID 1001 → 응답에 ID 1001 포함).

시간적 일관성을 보장합니다(예: 종료 시간이 항상 시작 시간 이후임).

관련 필드를 계산합니다(예: 수량과 단가를 기반으로 한 총 가격).

응답 페이로드에 요청 매개변수를 반영합니다.

목 스크립트 작동 방식

목 스크립트는 5단계 워크플로를 통해 데이터를 처리합니다.

Smart mock 또는 기타 목 기능이 초기 응답을 생성합니다.

목 스크립트가 $$.mockResponse 및 $$.mockRequest 객체에 접근합니다.

JavaScript 로직이 이러한 객체에서 데이터를 검색하고 처리합니다.

$$.mockResponse.setBody 메서드가 수정된 데이터로 응답을 업데이트합니다.

목 엔진이 최종 처리된 응답을 반환합니다.

목 스크립트는 Smart mock에서만 작동합니다. 목 기대값 또는 응답 예시에는 적용되지 않습니다.

목 스크립트 사용

스크립트 활성화 및 작성

하단에 Mock Script 섹션이 표시되는 Mock 탭으로 이동합니다.

스크립트 스위치를 켭니다.

편집기에서 스크립트를 작성하고 저장합니다.

스크립트 참조

기본 예시

이 스크립트가 수행하는 작업:

처음에 자동 생성된 목 응답을 검색합니다.

다음과 같이 응답을 수정합니다.

page를 요청된 page 매개변수와 일치하도록 설정합니다.

고정된 total 값을 120으로 설정합니다.

이러한 변경 사항으로 목 응답을 업데이트합니다.

`$$.mockRequest` 객체

$$.mockRequest 객체는 들어오는 요청을 나타냅니다. 추가 기능이 포함되어 있으며 Postman의 pm.request 객체와 유사합니다.

주요 메서드:

메서드/속성	설명
`getParam(key)`	임의의 위치(query, body 등)에서 매개변수를 검색합니다.
`headers`	HTTP 헤더에 접근합니다.
`cookies`	쿠키 값에 접근합니다.
`body`	요청 본문에 접근합니다.
`formdata`	form-data 매개변수에 접근합니다.
`urlencoded`	URL 인코딩된 매개변수에 접근합니다.

사용 예시:

`$$.mockResponse` 객체

$$.mockResponse 객체는 다시 전송되는 응답을 나타냅니다. 추가 제어 메서드가 포함되어 있으며 Postman의 pm.response 객체와 유사합니다.

주요 메서드:

메서드	매개변수	설명
`setBody(body)`	any	응답 본문을 설정합니다.
`setCode(code)`	number	HTTP 상태 코드를 설정합니다.
`setDelay(duration)`	number (ms)	응답 지연을 추가합니다(지연 시간 시뮬레이션).
`json()`	-	응답을 JSON으로 검색합니다.
`headers`	-	응답 헤더에 접근하거나 수정합니다.

사용 예시:

FAQ

Q: 목 스크립트에서 Apidog 변수를 사용하는 방법은 무엇입니까?

A: 목 스크립트는 Apidog 변수를 사용할 수 없습니다.

변수는 Apidog 클라이언트의 기능이지만, 목 엔진은 독립적으로 실행되며 클라이언트 측 변수에 접근할 수 없습니다.

Q: 목 스크립트에서 로그 문을 사용하는 방법은 무엇입니까?

A: 목 스크립트는 로깅 기능을 제공하지 않습니다.

콘솔은 클라이언트 측 기능이지만, 목 엔진은 별도로 작동하며 클라이언트 콘솔로 로그를 출력할 수 없습니다.

Q: 목 스크립트에서 pm 객체를 사용할 수 없는 이유는 무엇입니까?

A: pm 객체는 목 스크립트에서 사용할 수 없습니다.

목 스크립트는 목 서버에서 실행되는 반면, pre/post 스크립트는 Apidog 클라이언트에서 실행됩니다. 이들은 사용 가능한 객체와 구문이 서로 다른 완전히 별개의 실행 환경입니다.

Q: 목 스크립트는 목 기대값과 함께 작동합니까?

A: 아니요. 목 스크립트는 Smart mock에서만 작동합니다.

목 기대값이 일치하면 목 스크립트는 실행되지 않습니다. 목 스크립트는 목 기대값 또는 응답 예시에 적용되지 않습니다.

사용 사례#

목 스크립트 작동 방식#

목 스크립트 사용#

스크립트 활성화 및 작성#

스크립트 참조#

기본 예시#

$$.mockRequest 객체#

$$.mockResponse 객체#

FAQ#

사용 사례

목 스크립트 작동 방식

목 스크립트 사용

스크립트 활성화 및 작성

스크립트 참조

기본 예시

`$$.mockRequest` 객체

`$$.mockResponse` 객체

FAQ