Mock Scripts

Mock scripts cho phép bạn tạo các phản hồi mock thông minh với các mối quan hệ logic giữa tham số yêu cầu và dữ liệu phản hồi. Tính năng này rất cần thiết khi bạn cần dữ liệu mock duy trì độ chính xác theo ngữ cảnh hoặc phản ánh các giá trị của yêu cầu.

Trường hợp sử dụng

Mock scripts lý tưởng cho các tình huống yêu cầu mối quan hệ dữ liệu logic:

Ví dụ phổ biến

Trả về ID người dùng trong phản hồi khớp với ID được yêu cầu (ví dụ: ID yêu cầu 1001 → phản hồi bao gồm ID 1001)

Đảm bảo tính nhất quán về thời gian (ví dụ: thời gian kết thúc luôn sau thời gian bắt đầu)

Tính toán các trường liên quan (ví dụ: tổng giá dựa trên số lượng và đơn giá)

Phản ánh các tham số yêu cầu trong payload phản hồi

Cách Mock Scripts hoạt động

Mock scripts xử lý dữ liệu thông qua quy trình gồm năm bước:

Smart mock hoặc các tính năng mock khác tạo một phản hồi ban đầu

Mock script truy cập các đối tượng $$.mockResponse và $$.mockRequest

Logic JavaScript truy xuất và xử lý dữ liệu từ các đối tượng này

Phương thức $$.mockResponse.setBody cập nhật phản hồi với dữ liệu đã chỉnh sửa

Mock engine trả về phản hồi cuối cùng đã được xử lý

Mock scripts chỉ hoạt động với Smart mock. Chúng không áp dụng cho mock expectations hoặc ví dụ phản hồi.

Sử dụng Mock Scripts

Bật và viết script

Điều hướng đến tab Mock, nơi phần Mock Script xuất hiện ở phía dưới

Bật công tắc script

Viết script của bạn trong trình soạn thảo và lưu

Tham chiếu script

Ví dụ cơ bản

Script này thực hiện những việc sau:

Truy xuất phản hồi mock ban đầu được tạo tự động

Chỉnh sửa phản hồi bằng cách:

Đặt page khớp với tham số trang được yêu cầu

Đặt giá trị total cố định là 120

Cập nhật phản hồi mock với các thay đổi này

Đối tượng $$.mockRequest

Đối tượng $$.mockRequest đại diện cho yêu cầu đến. Nó tương tự đối tượng pm.request của Postman nhưng có thêm các tính năng bổ sung.

Phương thức chính:

Phương thức/Thuộc tính	Mô tả
`getParam(key)`	Truy xuất tham số từ bất kỳ vị trí nào (query, body, v.v.)
`headers`	Truy cập HTTP headers
`cookies`	Truy cập giá trị cookie
`body`	Truy cập body của yêu cầu
`formdata`	Truy cập tham số form-data
`urlencoded`	Truy cập tham số được mã hóa URL

Ví dụ sử dụng:

Đối tượng $$.mockResponse

Đối tượng $$.mockResponse đại diện cho phản hồi được gửi lại. Nó tương tự đối tượng pm.response của Postman nhưng có thêm các phương thức điều khiển bổ sung.

Phương thức chính:

Phương thức	Tham số	Mô tả
`setBody(body)`	any	Đặt body của phản hồi
`setCode(code)`	number	Đặt mã trạng thái HTTP
`setDelay(duration)`	number (ms)	Thêm độ trễ phản hồi (mô phỏng độ trễ mạng)
`json()`	-	Truy xuất phản hồi dưới dạng JSON
`headers`	-	Truy cập/chỉnh sửa headers của phản hồi

Ví dụ sử dụng:

Câu hỏi thường gặp

Hỏi: Làm thế nào để sử dụng biến Apidog trong mock scripts?

Đáp: Mock scripts không thể sử dụng biến Apidog.

Biến là một tính năng của Apidog client, nhưng mock engine chạy độc lập và không thể truy cập các biến phía client.

Hỏi: Làm thế nào để sử dụng câu lệnh log trong mock scripts?

Đáp: Mock scripts không cung cấp chức năng ghi log.

Console là một tính năng phía client, nhưng mock engine hoạt động riêng biệt và không thể xuất log ra console của client.

Hỏi: Tại sao tôi không thể sử dụng đối tượng pm trong mock scripts?

Đáp: Đối tượng pm không khả dụng trong mock scripts.

Mock scripts thực thi trên mock server, trong khi pre/post scripts thực thi trên Apidog client. Đây là các môi trường thực thi hoàn toàn khác nhau với các đối tượng và cú pháp khả dụng khác nhau.

Hỏi: Mock scripts có hoạt động với mock expectations không?

Đáp: Không, mock scripts chỉ hoạt động với Smart mock.

Khi một mock expectation được khớp, mock script sẽ không thực thi. Mock scripts không áp dụng cho mock expectations hoặc ví dụ phản hồi.

Trường hợp sử dụng#

Cách Mock Scripts hoạt động#

Sử dụng Mock Scripts#

Bật và viết script#

Tham chiếu script#

Ví dụ cơ bản#

Đối tượng $$.mockRequest#

Đối tượng $$.mockResponse#

Câu hỏi thường gặp#

Trường hợp sử dụng

Cách Mock Scripts hoạt động

Sử dụng Mock Scripts

Bật và viết script

Tham chiếu script

Ví dụ cơ bản

Đối tượng $$.mockRequest

Đối tượng $$.mockResponse

Câu hỏi thường gặp