Crypto.js报错digest method cant be used的原因与解决方案

问题现象 #

调用createHash.update.digest方法链执行哈希计算时持续抛出错误，最初无法定位问题根源，排查后确认是代码存在拼写错误，但抛出的错误提示和实际问题不匹配，存在较强误导性。
具体错误信息：

digest method cant be used

触发报错的原始代码：

this.passwordResetToken = crypto.createHash('sh256').update(resetToken).digest('hex');

修复方案 #

修正传入createHash方法的哈希算法名称拼写：将漏写字母a的错误算法名sh256改为正确的sha256即可解决问题。
修复后代码：

this.passwordResetToken = crypto.createHash('sha256').update(resetToken).digest('hex');

错误提示不匹配根因的原因 #

仅算法名称拼写错误，却抛出digest方法不可用的提示，本质是Crypto.js的错误处理逻辑设计缺陷导致的：

• 当传入createHash的算法名非法、不受支持时，方法不会立刻抛出明确的「无效哈希算法」错误，也不会返回正常的Hash计算实例，只会返回一个标记为初始化失败的异常状态对象，这个对象上没有绑定可用的digest、update方法实现。
• 等到链式调用执行到digest方法时，内部逻辑检测到当前实例处于初始化失败的异常状态，没有可用的digest执行逻辑，就直接抛出了「digest method cant be used」的泛化错误，完全没有提及真正的故障点是传入了错误的算法名称，最终导致错误提示和实际问题完全不匹配，很容易误导排查方向。
• 碰到这类链式调用的报错，如果错误提示和当前调用方法的逻辑明显不符，可以把整段链式调用拆成独立的单步语句逐行执行、打印每一步的返回结果，就能快速定位到最早出现异常返回的节点，不用在最后抛出错误的方法上浪费排查时间。

内容的提问来源于stack exchange，提问作者Ido Shay