基于原生DnD与浏览器API实现文件上传,递归构建文件树仅返回首个结果
异常产生的核心成因
所有问题的根源是你当前实现的文件树构建逻辑全为异步回调模式,但你在同步执行流中立刻对未完成构建的文件树做了读取、序列化操作,具体的时序错位逻辑可以拆解为两部分:
- 所有涉及文件/目录的读取操作,都是浏览器侧的异步回调:
entry.file()获取文件元信息的操作,回调执行时机在当前同步代码块跑完之后dirReader.readEntries()读取目录下条目的操作,回调执行时机也在当前同步代码块跑完之后- 递归遍历过程中的每一层目录读取、每一个文件拉取,都会依次进入异步任务队列排队执行,不会阻塞当前的同步代码流程
- DevTools的打印特性放大了问题的迷惑性:
console.log打印普通对象时,不会存储打印时刻的对象快照,而是存储对象的内存引用。当所有异步任务执行完成、文件树被补全全量数据后,你点开控制台查看打印的对象时,读到的是已经填充完整的最新内存值,所以会误以为打印时刻的文件树就是完整的。
而你紧接着执行的JSON.stringify()、Object.keys()是同步代码,运行时机在所有异步任务入队之后、但还没开始执行的阶段,这时候文件树里只写入了最开始同步流程能碰到的1个根条目,自然只会拿到1条的结果。
排查验证方法
可以通过两个简单操作快速验证上述成因:
- 把原来的
console.log(finalFiles)替换为console.log(JSON.parse(JSON.stringify(finalFiles))),这是强制打印时刻的对象快照,你会看到输出结果和你序列化拿到的单条结果完全一致,根本不是全量数据 - 把同步执行的
JSON.stringify(finalFiles)、Object.keys(finalFiles).length挪到setTimeout延时回调里(比如延时1000ms再执行),等所有异步任务跑完后再读文件树,你会立刻拿到全量的正确数据。
解决方案
需要把原来基于回调的异步逻辑改造为Promise模式,等所有遍历、文件读取的异步操作全部完成后,再向外返回完整的文件树,具体改造点包括:
- 把单个文件元信息获取、单批次目录读取的回调逻辑包装成可await的Promise
- 适配浏览器File System API的规则:
dirReader.readEntries()单次最多返回100个目录条目,必须循环调用直到返回空数组,才算读完目录下的全部内容 - 所有递归遍历逻辑增加异步等待,等当前节点的所有子节点全部遍历完成后,才算当前节点处理完毕
- 最终的
buildFileTree函数返回Promise,调用侧需要通过await拿到最终结果
重构后的参考实现
// 单个文件条目转Promise,解决回调嵌套 function getFileEntryMeta(fileEntry) { return new Promise((resolve) => { fileEntry.file(file => { resolve({ id: uuidv4(), name: fileEntry.name, parent_id: null, file: fileEntry }) }) }) } // 读取目录下全量条目,解决readEntries单次返回上限的问题 function readAllDirEntries(dirReader) { return new Promise((resolve) => { let allEntries = [] function readBatch() { dirReader.readEntries(entries => { if (!entries.length) { resolve(allEntries) return } allEntries = allEntries.concat(entries) readBatch() }) } readBatch() }) } // 递归遍历逻辑改造为async async function traverseFileTree(fileTree, parentPath, entry) { const parentNode = parentPath ? fileTree[parentPath] : null const parentId = parentNode?.id ?? null if (entry.isFile) { const fileMeta = await getFileEntryMeta(entry) fileMeta.parent_id = parentId fileTree[entry.fullPath] = fileMeta return } if (entry.isDirectory) { // 先写入当前目录的元信息 fileTree[entry.fullPath] = { id: uuidv4(), name: entry.name, is_directory: true, parent_id: parentId, file: null } // 读取当前目录下所有子条目,等待全部子条目遍历完成 const childEntries = await readAllDirEntries(entry.createReader()) await Promise.all( childEntries.map(child => traverseFileTree(fileTree, entry.fullPath, child)) ) } } // 构建函数改造为async,等所有顶层条目遍历完成再返回结果 export async function buildFileTree(allEntries) { const fileTree = {} await Promise.all( allEntries.map(entry => traverseFileTree(fileTree, null, entry)) ) return fileTree }
调用侧的适配修改
const handleUploadDrop = async (files) => { // 等待所有异步流程完成,拿到构建完成的文件树 const finalFiles = await buildFileTree(files) // 此时执行序列化、遍历、长度获取均可拿到正确结果 console.log(finalFiles) console.log(JSON.stringify(finalFiles)) console.log(Object.keys(finalFiles).length) }
内容的提问来源于stack exchange,提问作者user1960118
相关产品推荐
相关产品推荐

