首页
/ ShellJS v0.9.0 版本发布:Node.js 命令行工具的重大更新

ShellJS v0.9.0 版本发布:Node.js 命令行工具的重大更新

2025-06-02 22:45:06作者:蔡怀权

ShellJS 是一个基于 Node.js 的跨平台 Unix shell 命令实现库,它允许开发者在 JavaScript 中直接执行常见的 shell 命令,如 cp、mv、rm 等,而无需担心平台差异。这个库特别适合需要在 Node.js 环境中执行文件系统操作和 shell 命令的场景。

核心功能改进

1. 文件操作增强

本次更新对文件操作命令进行了多项改进:

  • cp 命令新增了 -u(update)标志支持,现在可以在递归复制时仅更新较新的文件
  • cp 命令增加了 preserve 选项,可以保留文件的原始属性
  • mv 命令修复了跨卷移动文件的问题
  • mkdir 命令改进了目录创建逻辑,解决了潜在的竞争条件问题

2. 命令执行优化

  • 新增 shell.cmd() 方法作为 exec() 的替代方案,提供了更安全的命令执行方式
  • exec() 方法增加了 fatal 布尔选项,可以控制错误是否致命
  • 改进了命令执行时的文件权限控制,增强了安全性
  • 错误处理增强,现在可以获取更详细的错误代码信息

3. 新功能特性

  • grep 命令新增 -n 选项支持,可以显示匹配行的行号
  • tail 命令增加了对 -n +NUM 格式的支持(带符号)
  • find 命令新增 -L 选项,可以跟随符号链接查找
  • sed 命令在使用 -i 选项时将静默执行

兼容性与稳定性提升

  • 移除了对 Node.js v4 和 v5 的支持
  • 增加了对 Node.js 最新版本(包括 v18、v20)的测试支持
  • 改进了跨平台兼容性,特别是 Windows 系统的支持
  • 使用 fast-glob 替代了原有的 glob 实现,提高了文件匹配性能

开发者体验改进

  • 文档全面更新,包括:
    • 明确了哪些方法返回 ShellStrings
    • 改进了 sed 命令处理换行符的说明
    • 新增了 ES6 导入方式的文档
    • 增强了 exec 命令的安全警告
  • 测试覆盖率显著提升
  • 代码质量改进,包括:
    • 使用 includes() 替代 indexOf()
    • 改进了引号处理逻辑
    • 优化了错误处理流程

安全增强

  • 加强了命令执行时的文件权限控制
  • 新增了 SECURITY.md 文件,明确了安全策略
  • 改进了 exec 方法的安全文档,强调了潜在风险

构建与维护改进

  • 迁移到 GitHub Actions 作为 CI 系统
  • 更新了所有开发依赖
  • 改进了测试环境,现在测试文件都在临时目录中创建
  • 移除了不再维护的 Gitter 集成

总结

ShellJS v0.9.0 是一个重要的版本更新,带来了诸多功能增强和安全改进。特别是新增的 shell.cmd() 方法和改进的 exec() 功能,为开发者提供了更安全、更灵活的命令执行方式。文件操作命令的增强使得 ShellJS 在处理文件系统任务时更加可靠和高效。对于需要在 Node.js 中执行 shell 命令的开发者来说,这个版本值得升级。

登录后查看全文
热门项目推荐
相关项目推荐