Home > SYS_FileSystem > saveFileToFileSystem

SYS_FileSystem.saveFileToFileSystem() method

此 API 当前处于 BETA 预览状态，希望得到开发者的反馈。它的任何功能都可能在接下来的开发进程中被修改，请不要将它用于任何正式环境。

向文件系统写入文件

签名

function saveFileToFileSystem(
	uri: string,
	fileData: File | Blob,
	fileName?: string,
): Promise<boolean>;

参数名

参数	类型	描述
uri	string	文件资源定位符 如若结尾为斜杠 /（Windows 为反斜杠 \），则识别为文件夹； 如若结尾非斜杠，则识别为完整文件名，此时 fileName 参数将被忽略
fileData	File | Blob	文件数据
fileName	string	（可选） 文件名称

返回值

Promise<boolean>

写入操作是否成功，如若不允许覆盖但文件已存在将返回 false 的结果

备注

注意 1：本接口仅客户端有效，在浏览器环境内调用将始终 throw Error

注意 2：本接口需要使用者启用扩展的外部交互权限，如若未启用将始终 throw Error

注意 3：CLI 本地文件写入**不做路径白名单校验**、不受 APP_PROJECT_DIR 限制；uri 结尾带斜杠 /（Windows 为反斜杠 \）识别为目录，force 控制是否覆盖已存在文件