让你的 JS 代码变得干净优雅且可维护

时间:2021-12-10 01:05:01

拒绝魔法

众所周知,魔法是这样的:

让你的 JS 代码变得干净优雅且可维护

哦,不是。。

在编程的世界里也有魔法,一般称其为:魔法数字,魔法变量,魔法字符串。例如这样:

  1. const a = await abcdefg();  
  2. console.log(a === 200);  
  3. const b = await asdfgh();  
  4. if (b === 0) {  
  5. } else if (b === 1) {  
  6. } else if (b === 2) {};  
  7. for (let i = 0; i < 10; i++) {}; 

以上直接出现的,莫名其妙的变量名,字符串以及判断条件数字,就叫魔法。。。

这种写法写出来的代码晦涩难懂,难以维护,隐藏 BUG 多,除非你准备给接手的人埋坑,或者准备辞职,不然千万别这么写(容易被打断腿)

那么怎么写才更优雅?

语义化

首先便是语义化。一个是变量,常量的语义化,例如:

  1. const SUCCESS_STATUS = 200 
  2. const requestStatus = await getStatus();  
  3. console.log(requestStatus === SUCCESS_STATUS);  
  4. const userRole = await getUserRole();  
  5. const GUEST_CODE = 0 
  6. const USER_CODE = 1 
  7. const ADMIN_CODE = 2 
  8. if (userRole === GUEST_CODE) { 
  9. } else if (userRole === USER_CODE) {  
  10. } else if (userRole === ADMIN_CODE) {};  
  11. const MAX_NUM = 10 
  12. const MIN_NUM = 0 
  13. for (let currentNum = MIN_NUM; currentNum < MAX_NUM; currentNum++) {}; 

一般的规则就是变量用小写,常量用大写,把变量名语义化,那么当你看到这段代码的时候,一眼就能知道它是做什么的,而不是非得要浪费时间看完上下文,或者是猜。

枚举

对于上面判断 userRole 的代码,其实我们可以用更优雅的方式去实现,那就是 枚举 。

按照*的说明:在数学和计算机科学理论中,一个集的枚举是列出某些有穷序列集的所有成员的程序,或者是一种特定类型对象的计数。这两种类型经常(但不总是)重叠。

其实就是组织收集有关联变量的一种方式。枚举的好处在于方便多状态的管理,以及可读性更强。例如:

  1. const ROLES = {  
  2.   GUEST: 0,  
  3.   USER: 1,  
  4.   ADMIN: 2  
  5. };  
  6. const userRole = await getUserRole();  
  7. if (userRole === ROLES.GUEST) {  
  8. } else if (userRole === ROLES.USER) {  
  9. } else if (userRole === ROLES.ADMIN) {}; 

通过枚举的方式归纳起来,维护起来更方便,而且要添加状态直接在 ROLES 对象里写就行,更方便快捷。

策略模式

*上说:策略模式作为一种软件设计模式,指对象有某个行为,但是在不同的场景中,该行为有不同的实现算法。

上面的代码依旧是可优化的,在这里我们可以利用策略模式来做进一层的优化。

具体的例子就是如下:

  1. const ROLES = {  
  2.   GUEST: 0,  
  3.   USER: 1,  
  4.   ADMIN: 2  
  5. };  
  6. const ROLE_METHODS = {  
  7.   [ROLES.GUEST]() {},  
  8.   [ROLES.USER]() {},  
  9.   [ROLES.ADMIN]() {},  
  10. };  
  11. const userRole = await getUserRole();  
  12. ROLE_METHODS[userRole](); 

通过上面的写法,我们可以知道,当我们需要增加角色,或者修改角色数字的时候,只需要修改 ROLES 里对应的字段,以及 ROLE_METHODS 里的方法即可,这样我们就可以将可能很冗长的 if...else 代码给抽离出来,颗粒度更细,更好维护。

更在状态

除了上面的方式之外,我们还可以利用“ 状态 ”的概念来写代码。在看代码之前,我们先了解下什么是 “有限状态机”。

根据*的解释:有限状态机(英语:finite-state machine,缩写:FSM)又称有限状态自动机(英语:finite-state automation,缩写:FSA),简称状态机,是表示有限个状态以及在这些状态之间的转移和动作等行为的数学计算模型。

例如我们熟悉的 Promise ,它就是在状态集:PENDIN 、 FULFILLED 、 REJECTED  之间单向流转的有限状态机。

状态机的概念跟策略模式类似,实现方式也类似,这里面最大的不同是在于 “语义” 。

策略模式更适合于互不依赖,同时只能存在一个状态的场景,例如:

  1. const 吃 = {  
  2.   沙县大酒店() {  
  3.     吃云吞()  
  4.   },  
  5.   开封菜() {  
  6.     吃汉堡()  
  7.   },  
  8.   在家() {  
  9.     吃外卖()  
  10.   }  
  11. }; 

这里面如果我们肚子饿了,就只能在 沙县大酒店() , 开封菜() , 在家() 这几个状态里选。

你不能都吃,当然以下情况除外。。。

让你的 JS 代码变得干净优雅且可维护

如果是状态模式,则会有这种情况:

  1. const 打工人 = {  
  2.   起床() {},  
  3.   上班() {},  
  4.   加班() {},  
  5.   下班() {}  
  6. };  
  7. // 早上6点  
  8. 打工人.起床();  
  9. // 早上9点  
  10. 打工人.上班();  
  11. // 晚上6点  
  12. 打工人.加班();  
  13. // 晚上12点  
  14. 打工人.下班(); 

这里的打工人根据不同的时间,进行不同的任务,便是打工人模式,哦不,状态模式。这里的时间就是状态。

我们举个实际的业务例子,就是订单列表页,通常我们的订单可能有这几种状态:

让你的 JS 代码变得干净优雅且可维护

不同的状态展示的 UI 也不同,所以我们以不同的状态划分好模块之后,代码写起来就会清晰很多,我们以 Vue 代码为例:

  1. // contants.js  
  2. export const ORDER_STATUS = {  
  3.   INIT: 0, // 初始化  
  4.   CREATED: 1, // 订单创建  
  5.   ARREARAGE: 2, // 待支付  
  6.   PURCHASED: 3, // 已购买  
  7.   SHIPPED: 4, // 已发货  
  8.   COMPLETED: 5 // 已完成  
  9. }; 
  1. // order.vue  
  2. <template>  
  3.   <div>  
  4.         <section v-if="orderIsInit"></section>  
  5.         <section v-if="orderIsCreated"></section>  
  6.         <section v-if="orderIsArrearage"></section>  
  7.         <section v-if="orderIsPurchased"></section>  
  8.         <section v-if="orderIsShipped"></section>  
  9.         <section v-if="orderIsCompleted"></section>  
  10.   </div>  
  11. </template> 
  12. <script>  
  13.   import ORDER_STATUS from './contants';  
  14.   import eq from 'lodash';  
  15.   export default {  
  16.     computed: {  
  17.       /**  
  18.        * @func  
  19.        * @name orderIsInit  
  20.        * @desc 判断订单是否初始化的状态  
  21.        * @returns {string} 判断订单是否初始化的状态  
  22.        */  
  23.       orderIsInit() {  
  24.         return eq(this.orderStatus, ORDER_STATUS.INIT);  
  25.       },  
  26.       /**  
  27.        * @func  
  28.        * @name orderIsCreated  
  29.        * @desc 判断订单是否已创建的状态  
  30.        * @returns {string} 订单是否已创建  
  31.        */  
  32.       orderIsCreated() {  
  33.         return eq(this.orderStatus, ORDER_STATUS.CREATED);  
  34.       },  
  35.       /**  
  36.        * @func  
  37.        * @name orderIsArrearage  
  38.        * @desc 判断订单是否未付款的状态  
  39.        * @returns {string} 订单是否未付款  
  40.        */  
  41.       orderIsArrearage() {  
  42.         return eq(this.orderStatus, ORDER_STATUS.ARREARAGE);  
  43.       },  
  44.       /**  
  45.        * @func  
  46.        * @name orderIsPurchased  
  47.        * @desc 判断订单是否已购买的状态  
  48.        * @returns {string} 订单是否已购买  
  49.        */  
  50.       orderIsPurchased() {  
  51.         return eq(this.orderStatus, ORDER_STATUS.PURCHASED);  
  52.       },  
  53.       /**  
  54.        * @func  
  55.        * @name orderIsShipped  
  56.        * @desc 判断订单是否已发货的状态  
  57.        * @returns {string} 订单是否已发货  
  58.        */  
  59.       orderIsShipped() {  
  60.         return eq(this.orderStatus, ORDER_STATUS.SHIPPED);  
  61.       },  
  62.       /**  
  63.        * @func  
  64.        * @name orderIsCompleted  
  65.        * @desc 判断订单是否已完成的状态  
  66.        * @returns {string} 订单是否已完成  
  67.        */  
  68.       orderIsCompleted() {  
  69.         return eq(this.orderStatus, ORDER_STATUS.COMPLETED);  
  70.       },  
  71.     },  
  72.     data() {  
  73.       return {  
  74.         orderStatus: ORDER_STATUS.INIT // 订单状态  
  75.       } 
  76.     },  
  77.     methods: {  
  78.       /**  
  79.        * @func  
  80.        * @name getOrderStatus  
  81.        * @desc 判断订单状态  
  82.        * @returns {string} 返回当前订单状态  
  83.        */  
  84.       async getOrderStatus() {}  
  85.     }, 
  86.     async created() {  
  87.       this.orderStatus = await this.getOrderStatus();  
  88.     }  
  89.   }  
  90. </script> 

将页面组件按状态划分,实现独立自治,这样子既能防止代码耦合,方便维护 debug,也方便开发者自测,如果需要看不同状态的展示效果,只要手动给 orderStatus 赋值即可,方便快捷。

面向切面

按照*的解释:面向切面的程序设计(Aspect-oriented programming,AOP,又译作面向方面的程序设计、剖面导向程序设计)是计算机科学中的一种程序设计思想,旨在将横切关注点与业务主体进行进一步分离,以提高程序代码的模块化程度。

上面这段文字估计没有什么人看,算了,直接上代码吧!

让你的 JS 代码变得干净优雅且可维护

我们看回上面打工人的场景,假定老板想要知道打工人每个状态开始前跟结束前的时间以及做点什么,那么该怎么做呢?这个时候我们不难想到可以直接往状态函数里写代码,例如:

  1. const 打工人 = {  
  2.   起床() {  
  3.     老板.start();  
  4.     打工人.do();  
  5.     老板.end();  
  6.   },  
  7.   上班() {  
  8.     老板.start();  
  9.     打工人.do();  
  10.     老板.end();  
  11.   },  
  12.   加班() {  
  13.     老板.start();  
  14.     打工人.do();  
  15.     老板.end();  
  16.   },  
  17.   下班() {  
  18.     老板.start();  
  19.     打工人.do();  
  20.     老板.end();  
  21.   }  
  22. };  
  23. // 早上6点  
  24. 打工人.起床();  
  25. // 早上9点  
  26. 打工人.上班();  
  27. // 晚上6点  
  28. 打工人.加班();  
  29. // 晚上12点  
  30. 打工人.下班(); 

但是这样打工人一下子就察觉到到了老板在监控他的生活,如果要做到不被人察觉(不影响业务逻辑),那我们既可以采用 AOP 的实现方式。代码如下:

  1. import eq from 'lodash';  
  2. const TYPES = {  
  3.   FUNCTION: 'function'  
  4.  
  5. const 老板监控中的打工人 = new Proxy(打工人, {  
  6.     get(target, key, value, receiver) {  
  7.         console.log('老板开始看你了~');  
  8.        const res = Reflect.get(target, key, value, receiver);  
  9.        const 打工人任务 = eq(typeof res, TYPES.FUNCTION) ? res() : res;  
  10.         console.log('老板开始记你小本本了~');  
  11.         return () => 打工人任务;  
  12.     }  
  13. }); 

所以我们可以看到以下结果:

让你的 JS 代码变得干净优雅且可维护

这样子,我们就可以轻松简单地监控到了打工人每天干的活,而且还不让打工人发现,简直是资本家听了都流泪呀。

原文地址:https://mp.weixin.qq.com/s/NgOzxnK8MTuy-e0a8hcKOQ