filesize.js 库中数字填充功能的注意事项

filesize.js 是一个用于将字节大小转换为易读格式（如"1.5 MB"）的JavaScript库。在使用过程中，开发者发现了一个关于数字填充功能的特殊情况需要注意。

问题现象

当使用filesize.js的pad选项时，如果满足以下两个条件：

1. 没有显式设置separator参数（使用默认值）
2. 转换结果的小数部分全为零

此时数字填充功能会失效。例如：

filesize(1001) // 输出 "1 kB"
filesize(1001, {round: 2, pad: true}) // 预期 "1.00 kB"，实际输出 "1 kB"

但如果显式设置了separator参数，功能则正常：

filesize(1001, {round: 2, pad: true, separator: '.'}) // 正确输出 "1.00 kB"

技术背景

filesize.js默认将separator设为空字符串，这是有意为之的设计选择。这样做的主要原因是避免在字符串拼接时产生不完整的浮点数表示。

pad选项的设计初衷是增强已有小数部分的显示（如将"1.1"补全为"1.10"），而不是将整数强制转换为带有小数部分的浮点数。

解决方案

对于需要强制显示固定小数位数的场景，filesize.js提供了更好的解决方案 - 使用precision参数：

filesize(1001, {precision: 3}) // 输出 "1.00 kB"
filesize(1024, {precision: 3, base: 2}) // 输出 "1.00 KiB"

precision参数会强制显示指定数量的有效数字，其行为类似于JavaScript的Number.toPrecision()方法。例如，precision为3时，可能的输出格式包括：

• xxx（整数）
• xx.x（一位小数）
• x.xx（两位小数）
• .xxx（纯小数）

注意事项

虽然precision参数能解决大部分需求，但在处理较小数值时可能会产生科学计数法表示：

filesize(110, {precision: 2}) // 输出 "1.1e+2 B"

因此，开发者需要根据实际需求选择合适的参数组合。如果需要严格的固定小数位数显示，建议同时使用separator和pad参数；如果更关注有效数字的显示，则使用precision参数更为合适。

filesize.js在10.1.5版本中已经修复了相关问题，开发者可以放心使用这些功能。