多狀態頁面中的 mock 方案
我們有時候會遇到一個業務頁面存在很多個狀態,甚至子狀態,比如訂單詳情就是其中的典型,涉及從訂單創建到訂單結束,以及售後等流程。維護起來每個狀態對應一份數據,雖然我們 QA 提供了數據構造平臺,但構造一份對應狀態的數據還是需要花費不少時間,而且串行流程一旦出錯的話只能重新來一遍。
後期維護階段也不容易構造對應狀態的數據,導致排查頁面問題比較耗時。
另外一個問題就是從頭熟悉業務的話成本比較高,如果有一個直觀的頁面能夠看到頁面樣式會好很多。
以上就是設計一個多狀態 mock 工具初衷,讓開發者在頁面中直接選擇對應狀態,就可以切換到對應頁面。
技術選型
目前轉轉 app 測試包,webview 頁面氣泡浮層已經有兩個了——客戶端工具和 eruda,再多就亂套了,所以最好集成在現有的工具基礎上。客戶端部分功能我們接觸不到也不瞭解,在現有條件下只有 eruda 可用。
Eruda 是一個很強大的前端頁面調試工具庫,我們客戶端 webview 也內置了,在測試包中可以很方便的藉助 eruda 調試頁面,觀察日誌。同時 eruda 也支持插件,通過插件來擴展 eruda 的功能。我們的工具就基於 eruda 插件來實現。
實現效果預覽:
總體流程如下:
整個流程大概三個部分組成
-
業務邏輯改造
-
Eruda 插件
-
Mock 數據整理
業務邏輯改造
首先要實現這樣一個方案核心依賴於業務使用的請求庫,以及是否能夠對請求庫進行修改。
我們業務使用的基於 axios 的請求庫,其暴露了實際發送請求的 adapter 邏輯,我們可以基於 adapter 來實現接口方法的攔截。
藉助 axios-mock-adapter[1],可以很方便的實現我們的需求。
import { axiosInstance } from '@zz/fetch';
import MockAdapter from 'axios-mock-adapter';
export const mock = new MockAdapter(axiosInstance)
try {
// 藉助 localstorage 實現 eruda 插件和 axios-mock-adapter 通信
const mockReqConf = JSON.parse(localStorage.getItem('_mock_req'))
if (mockReqConf && mockReqConf.mockId) {
mock.onGet(api.getOrderDetail).reply(config => {
// console.log('mock api', api.getOrderDetail)
return axiosInstance.get('https://mockrepository.zhuanzhuan.com/orderdetail?mockId=' + mockReqConf.mockId)
})
}
mock.onAny()
.passThrough()
const isProduction = process.env.NODE_ENV === 'production'
if (isProduction || (mockReqConf && mockReqConf.mockId === '')) {
// sessionStorage 實現開關,如果沒有此配置,就重置設置的 mock 攔截
if (!sessionStorage.getItem('mock-adapter')) {
mock.restore()
}
}
} catch (error) {
console.log('mock adapter config error', error)
}
Eruda 插件
插件的目的是實現兩個功能,一個是總開關,另一個是 mock 數據的展示和切換。
總開關藉助 sessionStorage,webview 關閉 sessionStorage 數據清除,這樣避免了一進入頁面就是 mock 數據,防止忘記關閉以及頻繁操作,需要的時候纔打開。
Mock 數據的展示配置在一個配置文件中,公司有統一的配置中心,基於攜程 Apollo 實現。這個文件的作用是映射對應的狀態和 mock 數據來源,來源是統一的,所以只用參數區分即可。
示例如下:
[
{
"id": "/order/detail",
"list": [
{
"title": "正向流程",
"list": [
{
"title": "下單待發貨",
"id": "1-0-1"
},
{
"title": "寄賣下單",
"id": "1-1-0"
},
{
"title": "發貨運輸中",
"id": "1-2-0"
},
{
"title": "平臺質檢",
"id": "1-3-0"
}
]
},
{
"title": "逆向流程",
"list": [
{
"title": "申請退回-退回中",
"id": "2-3-2"
}
]
}
]
}
]
id
用於標識當前頁面鏈接,是否有配置 mock 數據,所以也支持配置多個頁面。
Eruda 插件的實現參考 eruda 官方文檔。
Eruda 如何寫插件 [2] https://github.com/liriliri/eruda/blob/master/doc/PLUGIN.md
Eruda 工具庫 [3] https://licia.liriliri.io/docs_cn.html
Eruda 插件寫法類比較像一個小的模板庫,eruda 提供了插件模板,綁定事件方式類似於 jQuery 語法,eruda 提供的 licia 工具庫均有對應方法,參考即可。
Eruda 插件示例代碼:
(function(root, factory) {
if (typeof define === 'function' && define.amd) {
define([], factory);
} else if (typeof module === 'object' && module.exports) {
module.exports = factory();
} else {
root.erudaPlugin = factory();
}
})(this, function() {
return function(eruda) {
var Tool = eruda.Tool,
util = eruda.util;
var Plugin = Tool.extend({
name: 'plugin',
init: function($el) {
this.callSuper(Tool, 'init', arguments);
this._style = util.evalCss(
[
'.eruda-dev-tools .eruda-tools .eruda-plugin {padding: 10px;}',
'.eruda-tip {padding: 10px; background: #fff; color: #263238;}'
].join('.eruda-dev-tools .eruda-tools .eruda-plugin ')
);
$el.html(
'<div class="eruda-tip">Put whatever you want here:)</div>'
);
},
show: function() {
this.callSuper(Tool, 'show', arguments);
},
hide: function() {
this.callSuper(Tool, 'hide', arguments);
},
destroy: function() {
this.callSuper(Tool, 'destroy', arguments);
util.evalCss.remove(this._style);
}
});
return new Plugin();
};
});
Mock 數據整理
這一部分其實是比較耗費體力的工作。需要整理每一個狀態的數據,存儲起來。前面提到公司提供的一個接口平臺,基於去哪兒 YAPI 搭建,其提供了每個接口 mock 能力,我們添加 mock 數據即可。前面配置文件中每一個狀態下的 id 其實就是 mock 數據的參數。
使用的時候,點選每一個狀態,將狀態值寫入 localStorage 當中,刷新頁面。axios 請求時檢測是否有 localStorage 配置,有的話取出對應值,拼接到 YAPI mock 接口請求當中,獲取到 mock 數據,然後頁面就是 mock 數據渲染出來的了。
初步嘗試後,可以讓我們在頁面開發過程中可以很方便得查看不同頁面下的頁面展現,相比於之前的要麼是查詢線上數據,要麼是通過數據構造一步一步找到對應狀態,都大大節省了時間,提升了效率。
同時對於產品和設計同學,也可以快速的找對對應頁面的樣子,方便產品對現有頁面進行調整,設計同學對頁面還原度進行檢查等等。
不足之處也有,就是數據的維護,現在每一個狀態下存儲的都是一份完整的數據,如果某一部分調整了的話,那麼所有的數據都要修改,數據越多,維護成本相對來說也越高。
以上是基於現有基礎能力搭建出來的一個簡單工具,當然還有更多改進空間,請多指教。
參考資料
[1]
axios-mock-adapter: https://github.com/ctimmerm/axios-mock-adapter
[2]
Eruda 如何寫插件: https://github.com/liriliri/eruda/blob/master/doc/PLUGIN.md
[3]
Eruda 工具庫: https://licia.liriliri.io/docs_cn.html
本文由 Readfog 進行 AMP 轉碼,版權歸原作者所有。
來源:https://mp.weixin.qq.com/s/dbqqnhIImGMy_qjam44Fug