我所理解的 JavaScript 最佳实践(27):让独立条件各自表达
- 使用现代化工具
- 尽量去掉只用一次的中间变量
- 遍历的起点决定按 ID 取数的顺序
- 不用 reduce
- 按遍历任务选择循环和数组方法
- 异步遍历按任务依赖选择并发或串行
- 卫语句让主流程保持平直
- 用函数给可复用的业务规则命名
- 让顺序无关的代码按名称排列
- 正确写注释
- 一行代码只做一件事
- 给函数起合适的名字
- 用空值合并运算符更好地控制默认值生效逻辑
- 用队列串行处理偏好更新,避免修改互相覆盖
- 确认弹窗关闭时,让等待中的 Promise 得到结果
- 用独立的预期值捕获实现错误
- 控制文件行数
- 控制函数圈复杂度和认知复杂度
- 使用工具函数进行类型判断
- 会演进的函数用对象参数
- 使用改进的原生 API
- 使用模板字符串优化多行文字展示
- 用查表取值,用 switch 分派动作
- 正确使用纯函数和副作用
- 避免数组空位
- 把条件写在可选元素和字段旁边
- 让独立条件各自表达(当前)
写分支时,我会先看后一项为什么要等前一项失败。如果自己的条件已经能决定该不该执行,就可以把条件直接写在动作旁边。遇到有优先级的处理、一个位置只选一种视图,或者要兜住剩余输入时,条件链能把这些约定写在代码里。
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 的条件渲染