# FileSystemManager.rename(Object object)

Promise 风格 调用:不支持

相关文档: 文件系统

# 功能描述

重命名文件。可以把文件从 oldPath 移动到 newPath

# 参数

# Object object

属性 类型 默认值 必填 说明
oldPath string 源文件路径,支持本地路径
newPath string 新文件路径,支持本地路径
success function 接口调用成功的回调函数
fail function 接口调用失败的回调函数
complete function 接口调用结束的回调函数(调用成功、失败都会执行)

# object.fail 回调函数

# 参数
# Object res
属性 类型 说明
errMsg string 错误信息
合法值 说明
fail permission denied, rename ${oldPath} -> ${newPath} 指定源文件或目标文件没有写权限
fail no such file or directory, rename ${oldPath} -> ${newPath} 源文件不存在,或目标文件路径的上层目录不存在

# 示例代码

const fs = wx.getFileSystemManager()
fs.rename({
  oldPath: `${wx.env.USER_DATA_PATH}/hello.txt`,
  newPath: `${wx.env.USER_DATA_PATH}/hello_new.txt`,
  success(res) {
    console.log(res)
  },
  fail(res) {
    console.error(res)
  }
})

// 同步接口
try {
  const res = fs.renameSync(
    `${wx.env.USER_DATA_PATH}/hello.txt`,
    `${wx.env.USER_DATA_PATH}/hello_new.txt`
  )
  console.log(res)
} catch(e) {
  console.error(e)
}