小程序开放平台

文档中心
基础
路由
跳转
转发
界面
网络
支付
数据缓存
媒体
位置
开放接口
设备
XHSML
性能
第三方平台
文件
removeSavedFile
openDocument
getFileSystemManager
FileSystemManager
FileSystemManager方法
access
accessSync
copyFile
mkdirSync
readdir
rmdirSync
saveFile
saveFileSync
unlink
unzip
writeFile
writeFileSync
数据分析
画布

xhs.saveFile

开发
>
JS API
>
文件
>
FileSystemManager方法
>
saveFile
>
更新时间:2025-04-11 19:14:15

以 Promise 风格 调用:不支持

功能描述

保存临时文件到本地。此接口会移动临时文件,因此调用成功后,tempFilePath 将不可用。

参数

Object object

属性
类型
默认值
必填
说明
tempFilePathstring临时存储文件路径 (本地路径)
filePathstring要存储的文件路径 (本地路径)
successfunction接口调用成功的回调函数
failfunction接口调用失败的回调函数
completefunction接口调用结束的回调函数(调用成功、失败都会执行)

object.success 回调函数

参数

Object res

属性
类型
说明
savedFilePathstring存储后的文件路径 (本地路径)

代码示例

function saveFile(tempFilePath, filePath = '') {
  xhs.saveFile({
    tempFilePath, // 临时存储文件路径
    filePath, // 可选:要存储的文件路径
    success: (res) => {
      console.log('文件保存成功:', res.savedFilePath); // 存储后的文件路径
    },
    fail: (err) => {
      console.error('文件保存失败:', err);
    },
    complete: () => {
      console.log('文件保存操作完成');
    }
  });
}

// 调用示例
saveFile('/path/to/temp/file.txt');