使用方法:
完全兼容 exceljs 所以原来对 exceljs
const ExcelJS = require('exceljs');
可以直接换成
const ExcelJS = require('@zurmokeeper/exceljs');
其它 API 的使用保持不变
-------------------------------------------------
const ExcelJS = require('@zurmokeeper/exceljs');
// 从文件读取
const workbook = new Excel.Workbook();
await workbook.xlsx.readFile(filename);
// 从文件读取, 解密使用密码加密的 excel 文件
const workbook = new Excel.Workbook();
await workbook.xlsx.readFile(filename, {password:'123456'});
// ... 使用 workbook
// 从流读取
const workbook = new Excel.Workbook();
await workbook.xlsx.read(stream);
// 从流读取, 解密使用密码加密的 excel 文件
const workbook = new Excel.Workbook();
await workbook.xlsx.read(stream, {password:'123456'});
// ... 使用 workbook
// 从 buffer 加载
const workbook = new Excel.Workbook();
await workbook.xlsx.load(data);
// 从 buffer 加载, 解密使用密码加密的 excel 文件
const workbook = new Excel.Workbook();
await workbook.xlsx.load(data, {password:'123456'});
// ... 使用 workbook
起因:
需要完成一个读取 WPS 带密码保密的 excel 功能,找遍了社区所有的库,都没有找到,一开始发现 xlsx-populate 支持解密,后面发现只支持 ecma376 agile encrytion 。是现在 office xlsx 格式的加密方式,不是 WPS 的加密方法,所以无法解密.
后面发现 WPS 对 xlsx 文件的加解密用的是 ecma376 standard encrytion. 然后参考官方文档和其他语言的库对照着来实现,比如 python 写的msoffcrypto-tool 和 go 的 excelize. 由于不是很懂加解密知识,实现的过程也是一波三折。具体的可以看 SF ,这里有几个链接,问题 1, 问题 2, 问题 3
本来是想给exceljs提PR的,但是发现exceljs快 2 年没人维护了,后面 23/4 月底的时候有几个维护者开始合并代码,但是进度很慢,而且中间还停滞了很久,而且这些维护者还不是作者本人,有没发布的权限也不了解,所以想用上这个解密功能不知道还要多久。
xlsx-populate 也是很久没有人维护了,而且xlsx-populate对于 ecma376 agile encrytion 的处理代码不是单独一个库来处理的,而我是把这些加解密的实现单独出来了一个包,officecrypto-tool,实现加解密的话,直接使用这个包就好了,也就不需要 xlsx-populate 原来关于加解密的那部分代码了,不知道人家会不会接受,所以也没有给 xlsx-populate 提PR了。
还有一个库,叫xlsx,是sheetjs出的,这个功能最广,支持读取 xls 格式。但是这个库其实是个社区版,阉割了加解密功能,看源码可以看到,写到加解密那部分的时候,然后代码就没有了,付费版才支持。所以估计是不会接受 PR 的。毕竟加了谁还买他们的付费版。
node.js 处理excel用的最多的 3 个库:
exceljs
API 最友好,文档最丰富,功能也强大,不支持加解密,不支持 xls, 快处于无人维护状态
xlsx-populate
API 一般,文档一般,但是支持 ecma376 agile encrytion 加解密,不支持 xls, 快处于无人维护状态
xlsx 社区版
API 一般,文档一般,不支持加解密,但是支持的文件格式最广,比如支持 xls 。由于是社区版,估计也不会加什么新功能了
所以在exceljs v4.3.0的基础写了这个 @zurmokeeper/exceljs
是基于 2023/5/5 exceljs 的最新提交代码上的,对比 v4.3.0 版本,解决了一些 bug 外(感谢其他开发者)。最重要的更新就是支持对 xlsx 文件的解密功能。加密功能TODO中。
现在的想法是想继续维护这个项目,其实本人是一直关注 exceljs 的,提过 PR,也回答了一些 issue ,但是苦于没有更多的权限,也不能够关闭 issue ,看着 issue 越来越多,其实很多是已经处理的,或者是重复的。也有很多不错的 PR 在那里放着。
如果 exceljs 继续更新代码, @zurmokeeper/exceljs 会尽量保持跟上,同时自己也会尽量去处理现在 exceljs 的 issue 和 pr ,然后更新在 @zurmokeeper/exceljs,也欢迎更多的开发者加入,issue 或者 pr 也好。不敢保证能做的多好,只能说尽力。项目地址