BOM中如何操作浏览器的文件系统API？

async function openLocalFile() {
    try {
        // 弹出文件选择器，用户可以选择一个或多个文件
        // 这里我们只取第一个文件句柄
        const [fileHandle] = await window.showOpenFilePicker({
            // 允许选择的文件类型，可选
            types: [{
                description: '文本文件',
                accept: {'text/plain': ['.txt', '.md']},
            }, {
                description: '图片文件',
                accept: {'image/*': ['.png', '.gif', '.jpeg', '.jpg']},
            }],
            multiple: false // 只允许选择一个文件
        });

        // 通过文件句柄获取文件对象
        const file = await fileHandle.getFile();
        const content = await file.text(); // 或者 file.arrayBuffer() / file.stream()
        console.log('文件名称:', file.name);
        console.log('文件内容:', content.substring(0, 200) + '...'); // 打印部分内容

        // 你还可以保存这个 fileHandle，以便后续对同一个文件进行写操作，
        // 只要用户没有撤销权限，或者浏览器会提示重新授权。
        return fileHandle;

    } catch (error) {
        // 用户取消选择，或者其他错误
        if (error.name === 'AbortError') {
            console.warn('用户取消了文件选择。');
        } else {
            console.error('打开文件时发生错误:', error);
        }
        return null;
    }
}

// 调用示例：
// openLocalFile().then(handle => {
//     if (handle) {
//         console.log('文件句柄已获取:', handle);
//     }
// });

async function saveContentToFile(content, suggestedName = 'untitled.txt') {
    try {
        // 弹出保存文件对话框
        const fileHandle = await window.showSaveFilePicker({
            suggestedName: suggestedName, // 建议的文件名
            types: [{
                description: '文本文件',
                accept: {'text/plain': ['.txt']},
            }],
        });

        // 创建一个可写流
        const writableStream = await fileHandle.createWritable();

        // 写入内容
        await writableStream.write(content);

        // 关闭流，完成写入
        await writableStream.close();

        console.log(`文件 "${fileHandle.name}" 保存成功！`);
        return fileHandle;

    } catch (error) {
        if (error.name === 'AbortError') {
            console.warn('用户取消了文件保存。');
        } else {
            console.error('保存文件时发生错误:', error);
        }
        return null;
    }
}

// 调用示例：
// saveContentToFile('Hello, File System API!', 'my-awesome-doc.txt');

async function accessDirectory() {
    try {
        const dirHandle = await window.showDirectoryPicker();
        console.log('已选择目录:', dirHandle.name);

        // 遍历目录内容
        for await (const entry of dirHandle.values()) {
            if (entry.kind === 'file') {
                console.log(`  文件: ${entry.name}`);
                // 如果需要读取文件内容，可以进一步调用 entry.getFile()
                // const file = await entry.getFile();
                // const content = await file.text();
            } else if (entry.kind === 'directory') {
                console.log(`  目录: ${entry.name}`);
                // 可以递归地进入子目录
                // const subDirHandle = await dirHandle.getDirectoryHandle(entry.name);
                // await accessDirectoryContent(subDirHandle);
            }
        }
        return dirHandle;

    } catch (error) {
        if (error.name === 'AbortError') {
            console.warn('用户取消了目录选择。');
        } else {
            console.error('访问目录时发生错误:', error);
        }
        return null;
    }
}

// 调用示例：
// accessDirectory();

if ('showOpenFilePicker' in window && window.isSecureContext) {
    // 浏览器支持 File System Access API 且处于安全上下文
    // 可以在这里使用 API
} else {
    // 浏览器不支持或不在安全上下文
    console.warn('当前浏览器或环境不支持 File System Access API。请使用 Chrome/Edge 并确保在 HTTPS 环境下。');
    // 提供备用方案，比如传统的 <input type="file">
    document.getElementById('fallbackFileInput').style.display = 'block';
}

async function someFileSystemOperation() {
    try {
        // ... 文件系统操作代码 ...
    } catch (error) {
        if (error.name === 'AbortError') {
            console.info('操作被用户取消。');
            // 可以给用户一个提示，或者什么都不做
        } else if (error.name === 'NotAllowedError') {
            console.error('权限不足，无法执行此操作。用户可能拒绝了权限或撤销了权限。');
            // 提示用户检查浏览器权限设置
        } else if (error.name === 'NotFoundError') {
            console.error('指定的文件或目录未找到。');
        } else {
            console.error('文件系统操作发生未知错误:', error);
        }
        // 根据错误类型，可能需要提供备用方案或用户反馈
    }
}