跳到正文

我所理解的 JavaScript 最佳实践(27):让独立条件各自表达

我所理解的 JavaScript 最佳实践

  1. 使用现代化工具
  2. 尽量去掉只用一次的中间变量
  3. 遍历的起点决定按 ID 取数的顺序
  4. 不用 reduce
  5. 按遍历任务选择循环和数组方法
  6. 异步遍历按任务依赖选择并发或串行
  7. 卫语句让主流程保持平直
  8. 用函数给可复用的业务规则命名
  9. 让顺序无关的代码按名称排列
  10. 正确写注释
  11. 一行代码只做一件事
  12. 给函数起合适的名字
  13. 用空值合并运算符更好地控制默认值生效逻辑
  14. 用队列串行处理偏好更新,避免修改互相覆盖
  15. 确认弹窗关闭时,让等待中的 Promise 得到结果
  16. 用独立的预期值捕获实现错误
  17. 控制文件行数
  18. 控制函数圈复杂度和认知复杂度
  19. 使用工具函数进行类型判断
  20. 会演进的函数用对象参数
  21. 使用改进的原生 API
  22. 使用模板字符串优化多行文字展示
  23. 用查表取值,用 switch 分派动作
  24. 正确使用纯函数和副作用
  25. 避免数组空位
  26. 把条件写在可选元素和字段旁边
  27. 让独立条件各自表达(当前)

写分支时,我会先看后一项为什么要等前一项失败。如果自己的条件已经能决定该不该执行,就可以把条件直接写在动作旁边。遇到有优先级的处理、一个位置只选一种视图,或者要兜住剩余输入时,条件链能把这些约定写在代码里。

else 承接前面所有条件都没覆盖的情况

读 if (a) { … } else if (b) { … } else { … } 时,光看 b 还不足以确定第二支何时执行。JavaScript 先检查 a,只有它为假才读取 b。在条件读取稳定的情况下,可以把每条路径写成下面的条件。ECMAScript 的 if 语句求值规则

分支 实际进入条件
if (a) a 成立
else if (b) !a && b 成立
else !a && !b 成立

末尾 else 覆盖的是前两支并集的补集。第二支只从这份剩余输入中取出满足 b 的一部分。若能确认 b 成立时 a 一定为假,就可以只读 b 来判断这一支。

独立的动作各自声明条件

以仓库工具的两条状态提示为例。Git 审阅摘要只在审阅模式下、且摘要已就绪时显示。索引提示只在其他模式有进度文案时显示。下面的 mode 是传入的字符串,两个动作分别更新自己的提示。

function updateNotices(mode, reviewReady, indexLabel) {
  if (mode === 'git-review' && reviewReady) {
    showReviewSummary();
  } else if (mode !== 'git-review' && indexLabel) {
    showIndexNotice(indexLabel);
  }
}

索引提示已经检查了 mode !== 'git-review'。这条条件一成立,第一支就进不去,else if 带来的额外前提在这里是冗余的。用两个 if 后,单看第二段就能判断要不要显示索引提示。

function updateNotices(mode, reviewReady, indexLabel) {
  if (mode === 'git-review' && reviewReady) {
    showReviewSummary();
  }
  if (mode !== 'git-review' && indexLabel) {
    showIndexNotice(indexLabel);
  }
}

mode !== 'git-review' 应当保留。Git 审阅刚打开时,reviewReady 还可能是假。如果只检查 indexLabel,就会借用其他模式的索引提示。这里的条件只读取本次调用的局部参数。拆开后多做一次简单判断,仍然会选出同样的动作。

有优先级或兜底时保留条件链

结果容器依次处理加载、错误和正文时,顺序直接决定界面的表现。加载期间即便还有上一轮的错误,也先显示加载。正文等到前两种状态都不成立才出现。

if (loading) {
  showLoading();
} else if (error) {
  showError(error);
} else {
  showContent();
}

只把中间的 else if 改成 if,末尾的 else 就只归第二个 if。此时 loading 为真、error 为空会同时显示加载和正文。即使各支条件互斥,一条链也可以用来表明这些分支共同选择一个结果,例如根据当前模式选择面板。按同一个值分派动作时,还可以用 switch 把选择关系表达出来。《用查表取值,用 switch 分派动作》

改写还可能改变条件本身的求值。如果第二支写成 readPermission() && mode === 'commands',放在 else if 里会等前序条件失败才调用 readPermission()。直接拆开后,即使当前模式不会进入这一支,也可能先读取权限。评估互斥时,可以先确认「哪些分支会进入」,再核对「为了做这个判断,实际会读取或调用什么」。

让 lint 提示可以核对的互斥关系

JavaScript 的 else if 和 Vue 的 v-else-if 都需要前序条件失败。Vue 模板中,索引提示的条件同样可以自己排除审阅模式。

<template>
  <review-summary v-if="mode === 'git-review' && reviewReady" />
  <index-notice v-else-if="mode !== 'git-review' && indexLabel" :message="indexLabel" />
</template>

@sheng/ts-prefer-independent-if 用同一条判断检查脚本和模板。它先核对各个条件是否比较同一个绑定,再检查本支的可能取值是否与所有前序分支都没有交集。严格的相等或不等比较、可解析的枚举成员和静态字面量集合能给出这一步所需的证据。规则按警告级别提示审阅,由开发者判断这里表达的是独立动作、集中分派还是需要维护的优先级。Vue 里还要核对条件链改写后的渲染行为,例如切换分支时组件怎么挂载。Vue 的条件渲染