Unstorage项目新增getKeys()方法的depth参数支持

Unstorage作为一款通用的键值存储解决方案，近期在其核心功能上进行了重要升级。开发团队为getKeys()方法新增了depth参数支持，这一改进显著提升了目录层级操作的灵活性。

功能背景

在实际开发场景中，特别是处理文件系统存储时，开发者经常需要管理具有层级结构的存储内容。以图片存储为例，用户可能将图片按不同分类存放在多级目录中。传统的getKeys()方法会递归返回所有层级的键名，这在某些场景下并不符合预期需求。

新增功能详解

新引入的depth参数允许开发者精确控制键名获取的深度：

1. 当depth设置为1时，仅返回当前层级的键名
2. 默认行为（不设置depth）保持向后兼容，递归获取所有层级的键名

这个功能特别适用于以下场景：

• 需要获取特定目录下的直接子项
• 构建文件浏览器界面时展示当前目录内容
• 优化性能，避免不必要的数据遍历

技术实现原理

在底层实现上，Unstorage通过两种方式支持这一特性：

1. 核心层过滤：对于不支持原生depth参数的存储驱动，Unstorage会在核心层进行键名过滤
2. 驱动原生支持：存储驱动可以声明maxDepth能力，直接提供最优化的实现

使用示例

// 获取当前层级键名
const currentLevelKeys = await storage.getKeys('', { depth: 1 })

// 传统方式获取所有层级键名
const allKeys = await storage.getKeys()

最佳实践建议

1. 对于文件系统类存储，优先使用支持原生depth参数的驱动
2. 在构建UI界面时，合理使用depth参数优化性能
3. 对于自定义存储驱动，建议实现maxDepth能力声明

这一改进使得Unstorage在处理层级化数据时更加灵活高效，为开发者提供了更精细的控制能力。