余小章 @ 大內殿堂

開發環境

• Windows 11
• Mockoon
  • 官方文件  Learn about Mockoon's documentation

安裝

Download Mockoon, the best API mocking tool

下列方式隨便挑一個自己喜歡的，個人偏好 scoop

scoop install mockoo
choco install mockoon
winget install mockoo

 

安裝完成後打開應用程式，就可以看到裡面已經有一個範例了，按下啟動就可以建立假的環境

接著尻尻看這個 API 在不在  curl --location 'http://localhost:3000/users

結果如下：

快速入門

參考文件：Mockoon GUI cheat sheet

新增環境

建立一個新的環境，選擇環境要存放的位置，這樣就可以得到一個假的環境了

 

新增的環境如下圖：

 

在 mockoon\storage 資料夾底下，就是環境配置檔，你只要把它複製出來，或是使用 Export，就能給其他人就可以使用

 

建立假端點

填上端點名字、回傳狀態、回傳結果，就建立好一個假的端點了

 

查看 Log

曾經尻了甚麼回傳了甚麼都在這裡

 

Mockoon templating helpers

Mockoon 還提供了一些工具讓模擬資料更方便

https://mockoon.com/docs/latest/templating/mockoon-helpers

動態產生假資料

例如 Faker.js aliases 加上 repeat，就可以動態產生一些假資料，這對於前端開發的幫助不小

[
  {{#repeat 5}}
  {
    "id": "{{guid}}",
    "title": "{{lorem 2}}",
    "name": "{{lastName}}.{{firstName}}",
    "created": {{boolean}}
  },
  {{/repeat}}
]

 

 

尻一下測試效果

 

Data

除了把資料寫在 inline 之外還可以使用 Data，預先建立好資料，再給不同的端點使用

選擇 Data，如下圖

CRUD

這個功能提供了資源 CRUD 操作，可以省掉一些配置的時間

匯入 Open API

除了自訂端點，也支援 Open API

下載官方的範例檔 OpenAPI-Specification/examples/v3.0/petstore.yaml at main · OAI/OpenAPI-Specification (github.com)

前後端的開發應該都是依照這一份合約，避免有不一致的現象發生

CLI

建立好端點之後，就可以透過 cli 來控制端點，安裝語法如下

npm install -g @mockoon/cli

mockoon/packages/cli at main · mockoon/mockoon (github.com)

使用步驟 Run your mock REST APIs anywhere with Mockoon CLI

當然也可以透過 docker 建立 cli mockoon/cli - Docker Image | Docker Hub

使用心得

Mockoon 提供了強大的操作介面，配置假端點變得更簡單，蠻適合 QA/前端開發；有點可惜，我沒有找到透過 cli 動態建立假端點的使用方式，這對於在寫場景自動化測試的時，沒有那麼適合我，自動化測試還是會傾向上一篇的用法 如何使用 Mock Server 建立假服務 | 余小章 @ 大內殿堂 - 點部落 (dotblogs.com.tw)

若有謬誤，煩請告知，新手發帖請多包涵

Microsoft MVP Award 2010~2017 C# 第四季
Microsoft MVP Award 2018~2022 .NET