推荐一个新的excel
处理库, @zurmokeeper/exceljs, 关键功能,支持xlsx文件的解密功能,文档地址,项目地址, 完全兼容exceljs
使用方法:
完全兼容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也好。不敢保证能做的多好,只能说尽力。项目地址