小程序API开发——文件FileSystemManager参数汇总

IoT砖家涂拉拉2024-02-07 8:33

创建智能小程序。

FileSystemManager.access

判断文件/目录是否存在

参数

Object object

判断文件/目录是否存在的回调函数

回调参数 Object res

属性 类型 默认值 必填 说明
path string 是 要判断是否存在的文件/目录路径 (本地路径)
complete function 否 接口调用结束的回调函数（调用成功、失败都会执行）
success function 否 接口调用成功的回调函数
fail function 否 接口调用失败的回调函数

函数定义示例

/**
 * 判断文件/目录是否存在
 */
export function access(params: {
  /** 要判断是否存在的文件/目录路径 (本地路径) */
  path: string;
  /** 接口调用结束的回调函数（调用成功、失败都会执行） */
  complete?: () => void;
  /** 接口调用成功的回调函数 */
  success?: (params: null) => void;
  /** 接口调用失败的回调函数 */
  fail?: (params: {
    errorMsg: string;
    errorCode: string | number;
    innerError: {
      errorCode: string | number;
      errorMsg: string;
    };
  }) => void;
}): void;

FileSystemManager.mkdir

创建目录，需要文件读写权限

参数

Object object

创建目录，需要文件读写权限的回调函数

回调参数 Object res

属性 类型 默认值 必填 说明
dirPath string 是 创建的目录路径 (本地路径)
recursive boolean 否 是否在递归创建该目录的上级目录后再创建该目录。如果对应的上级目录已经存在，则不创建该上级目录。 如 dirPath 为 a/b/c/d 且 recursive 为 true，将创建 a 目录，再在 a 目录下创建 b 目录， 以此类推直至创建 a/b/c 目录下的 d 目录。 默认值：false
complete function 否 接口调用结束的回调函数（调用成功、失败都会执行）
success function 否 接口调用成功的回调函数
fail function 否 接口调用失败的回调函数

函数定义示例

/**
 * 创建目录，需要文件读写权限
 */
export function mkdir(params: {
  /** 创建的目录路径 (本地路径) */
  dirPath: string;
  /**
   * 是否在递归创建该目录的上级目录后再创建该目录。如果对应的上级目录已经存在，则不创建该上级目录。
   * 如 dirPath 为 a/b/c/d 且 recursive 为 true，将创建 a 目录，再在 a 目录下创建 b 目录，
   * 以此类推直至创建 a/b/c 目录下的 d 目录。
   * 默认值：false
   */
  recursive?: boolean;
  /** 接口调用结束的回调函数（调用成功、失败都会执行） */
  complete?: () => void;
  /** 接口调用成功的回调函数 */
  success?: (params: null) => void;
  /** 接口调用失败的回调函数 */
  fail?: (params: {
    errorMsg: string;
    errorCode: string | number;
    innerError: {
      errorCode: string | number;
      errorMsg: string;
    };
  }) => void;
}): void;

FileSystemManager.mkdirSync

创建目录同步方法，需要文件读写权限

参数

Object object

创建目录，需要文件读写权限的回调函数

回调参数 Object res

属性 类型 默认值 必填 说明
fileId string 是 taskId
dirPath string 是 创建的目录路径 (本地路径)
recursive boolean 否 是否在递归创建该目录的上级目录后再创建该目录。如果对应的上级目录已经存在，则不创建该上级目录。 如 dirPath 为 a/b/c/d 且 recursive 为 true，将创建 a 目录，再在 a 目录下创建 b 目录， 以此类推直至创建 a/b/c 目录下的 d 目录。 默认值：false

函数定义示例

/**
 * 创建目录，需要文件读写权限
 */
export function mkdirSync(params: {
  /** taskId */
  fileId: string;
  /** 创建的目录路径 (本地路径) */
  dirPath: string;
  /**
   * 是否在递归创建该目录的上级目录后再创建该目录。如果对应的上级目录已经存在，则不创建该上级目录。
   * 如 dirPath 为 a/b/c/d 且 recursive 为 true，将创建 a 目录，再在 a 目录下创建 b 目录，
   * 以此类推直至创建 a/b/c 目录下的 d 目录。
   * 默认值：false
   */
  recursive?: boolean;
}): null;

FileSystemManager.readFile

读取本地文件内容

参数

Object object

读取本地文件内容的回调函数

回调参数 Object res

属性 类型 默认值 必填 说明
filePath string 是 要写入的文件路径 (本地路径)
encoding string 否 指定读取文件的字符编码。 支持 utf8/ascii/base64。如果不传 encoding，默认 utf8
position number 否 从文件指定位置开始读，如果不指定，则从文件头开始读。读取的范围应该是左闭右开区间 [position, position+length)。有效范围：[0, fileLength - 1]。单位：byte
length number 否 指定文件的长度，如果不指定，则读到文件末尾。有效范围：[1, fileLength]。单位：byte
complete function 否 接口调用结束的回调函数（调用成功、失败都会执行）
success function 否 接口调用成功的回调函数
fail function 否 接口调用失败的回调函数

object.success 回调参数

参数

Object res

属性 类型 说明
data string 文件内容

object.fail 回调参数

参数

Object res

属性 类型 说明
errorMsg string 插件错误信息
errorCode string 错误码
innerError object 插件外部依赖错误信息 {errorMsg: string, errorCode: string }

函数定义示例

/**
 * 读取本地文件内容
 */
export function readFile(params: {
  /** 要写入的文件路径 (本地路径) */
  filePath: string;
  /**
   * 指定读取文件的字符编码。
   * 支持 utf8/ascii/base64。如果不传 encoding，默认utf8
   */
  encoding?: string;
  /** 从文件指定位置开始读，如果不指定，则从文件头开始读。读取的范围应该是左闭右开区间 [position, position+length)。有效范围：[0, fileLength - 1]。单位：byte */
  position?: number;
  /** 指定文件的长度，如果不指定，则读到文件末尾。有效范围：[1, fileLength]。单位：byte */
  length?: number;
  /** 接口调用结束的回调函数（调用成功、失败都会执行） */
  complete?: () => void;
  /** 接口调用成功的回调函数 */
  success?: (params: {
    /** 文件内容 */
    data: string;
  }) => void;
  /** 接口调用失败的回调函数 */
  fail?: (params: {
    errorMsg: string;
    errorCode: string | number;
    innerError: {
      errorCode: string | number;
      errorMsg: string;
    };
  }) => void;
}): void;

FileSystemManager.readFileSync

读取本地文件内容同步方法

参数

Object object

读取本地文件内容的回调函数

回调参数 Object res

属性 类型 默认值 必填 说明
filePath string 是 要写入的文件路径 (本地路径)
encoding string 否 指定读取文件的字符编码。 支持 utf8/ascii/base64。如果不传 encoding，默认 utf8
position number 否 从文件指定位置开始读，如果不指定，则从文件头开始读。读取的范围应该是左闭右开区间 [position, position+length)。有效范围：[0, fileLength - 1]。单位：byte
length number 否 指定文件的长度，如果不指定，则读到文件末尾。有效范围：[1, fileLength]。单位：byte

返回值

属性 类型 说明
data string 文件内容

函数定义示例

/**
 * 读取本地文件内容
 */
export function readFileSync(params: {
  /** 要写入的文件路径 (本地路径) */
  filePath: string;
  /**
   * 指定读取文件的字符编码。
   * 支持 utf8/ascii/base64。如果不传 encoding，默认utf8
   */
  encoding?: string;
  /** 从文件指定位置开始读，如果不指定，则从文件头开始读。读取的范围应该是左闭右开区间 [position, position+length)。有效范围：[0, fileLength - 1]。单位：byte */
  position?: number;
  /** 指定文件的长度，如果不指定，则读到文件末尾。有效范围：[1, fileLength]。单位：byte */
  length?: number;
}): {
  /** 文件内容 */
  data: string;
};

FileSystemManager.removeSavedFile

删除已保存的本地缓存文件，需要文件读写权限

参数

Object object

删除已保存的本地缓存文件，需要文件读写权限的回调函数

回调参数 Object res

属性 类型 默认值 必填 说明
filePath string 是 需要删除的文件路径 (本地路径)
complete function 否 接口调用结束的回调函数（调用成功、失败都会执行）
success function 否 接口调用成功的回调函数
fail function 否 接口调用失败的回调函数

函数定义示例

/**
 * 删除已保存的本地缓存文件，需要文件读写权限
 */
export function removeSavedFile(params: {
  /** 需要删除的文件路径 (本地路径) */
  filePath: string;
  /** 接口调用结束的回调函数（调用成功、失败都会执行） */
  complete?: () => void;
  /** 接口调用成功的回调函数 */
  success?: (params: null) => void;
  /** 接口调用失败的回调函数 */
  fail?: (params: {
    errorMsg: string;
    errorCode: string | number;
    innerError: {
      errorCode: string | number;
      errorMsg: string;
    };
  }) => void;
}): void;

FileSystemManager.mkdir

创建目录，需要文件读写权限

参数

Object object

删除目录，需要文件读写权限的回调函数

回调参数 Object res

属性 类型 默认值 必填 说明
dirPath string 是 要删除的目录路径 (本地路径)
recursive boolean 否 是否递归删除目录。如果为 true，则删除该目录和该目录下的所有子目录以及文件。 默认值：false
complete function 否 接口调用结束的回调函数（调用成功、失败都会执行）
success function 否 接口调用成功的回调函数
fail function 否 接口调用失败的回调函数

函数定义示例

/**
 * 删除目录，需要文件读写权限
 */
export function rmdir(params: {
  /** 要删除的目录路径 (本地路径) */
  dirPath: string;
  /**
   * 是否递归删除目录。如果为 true，则删除该目录和该目录下的所有子目录以及文件。
   * 默认值：false
   */
  recursive?: boolean;
  /** 接口调用结束的回调函数（调用成功、失败都会执行） */
  complete?: () => void;
  /** 接口调用成功的回调函数 */
  success?: (params: null) => void;
  /** 接口调用失败的回调函数 */
  fail?: (params: {
    errorMsg: string;
    errorCode: string | number;
    innerError: {
      errorCode: string | number;
      errorMsg: string;
    };
  }) => void;
}): void;

FileSystemManager.mkdirSync

创建目录同步方法，需要文件读写权限

参数

Object object

删除目录，需要文件读写权限的回调函数

回调参数 Object res

属性 类型 默认值 必填 说明
fileId string 是 taskId
dirPath string 是 要删除的目录路径 (本地路径)
recursive boolean 否 是否递归删除目录。如果为 true，则删除该目录和该目录下的所有子目录以及文件。 默认值：false

函数定义示例

/**
 * 删除目录，需要文件读写权限
 */
export function rmdirSync(params: {
  /** taskId */
  fileId: string;
  /** 要删除的目录路径 (本地路径) */
  dirPath: string;
  /**
   * 是否递归删除目录。如果为 true，则删除该目录和该目录下的所有子目录以及文件。
   * 默认值：false
   */
  recursive?: boolean;
}): null;

FileSystemManager.saveFile

文件保存的同步方法， 在完成文件保存后调用回调， 需要与 getTempDirectory 配合使用， 目标路径会校验是否包含 getTempDirectory 前缀

参数

Object object

文件保存的同步方法， 在完成文件保存后调用回调， 需要与 getTempDirectory 配合使用， 目标路径会校验是否包含 getTempDirectory 前缀的回调函数

回调参数 Object res

属性 类型 默认值 必填 说明
tempFilePath string 是 临时存储文件路径
filePath string 是 要存储的文件路径
complete function 否 接口调用完成的回调函数（成功或失败都会执行）
success function 否 接口调用成功的回调函数
fail function 否 接口调用失败的回调函数

object.success 回调参数

参数

Object res

属性 类型 说明
savedFilePath string 【待废弃， 不建议使用】存储后的文件路径

object.fail 回调参数

参数

Object res

属性 类型 说明
errorMsg string 插件错误信息
errorCode string 错误码
innerError object 插件外部依赖错误信息 {errorMsg: string, errorCode: string }

函数定义示例

/**
 * 文件保存的同步方法， 在完成文件保存后调用回调， 需要与getTempDirectory配合使用， 目标路径会校验是否包含getTempDirectory前缀
 */
export function saveFile(params: {
  /** 临时存储文件路径 */
  tempFilePath: string;
  /** 要存储的文件路径 */
  filePath: string;
  /** 接口调用结束的回调函数（调用成功、失败都会执行） */
  complete?: () => void;
  /** 接口调用成功的回调函数 */
  success?: (params: {
    /** 【待废弃， 不建议使用】存储后的文件路径 */
    savedFilePath: string;
  }) => void;
  /** 接口调用失败的回调函数 */
  fail?: (params: {
    errorMsg: string;
    errorCode: string | number;
    innerError: {
      errorCode: string | number;
      errorMsg: string;
    };
  }) => void;
}): void;

FileSystemManager.saveFileSync

文件保存的同步方法， 在完成文件保存后调用回调， 需要与 getTempDirectory 配合使用， 目标路径会校验是否包含 getTempDirectory 前缀同步方法

参数

Object object

文件保存的同步方法， 在完成文件保存后调用回调， 需要与 getTempDirectory 配合使用， 目标路径会校验是否包含 getTempDirectory 前缀的回调函数

回调参数 Object res

属性 类型 默认值 必填 说明
fileId string 是 taskId
tempFilePath string 是 临时存储文件路径
filePath string 是 要存储的文件路径

返回值

属性 类型 说明
savedFilePath string 【待废弃， 不建议使用】存储后的文件路径

函数定义示例

/**
 * 文件保存的同步方法， 在完成文件保存后调用回调， 需要与getTempDirectory配合使用， 目标路径会校验是否包含getTempDirectory前缀
 */
export function saveFileSync(params: {
  /** taskId */
  fileId: string;
  /** 临时存储文件路径 */
  tempFilePath: string;
  /** 要存储的文件路径 */
  filePath: string;
}): {
  /** 【待废弃， 不建议使用】存储后的文件路径 */
  savedFilePath: string;
};

FileSystemManager.stat

获取文件 Stats 对象，需要文件读写权限

参数

Object object

获取文件 Stats 对象，需要文件读写权限的回调函数

回调参数 Object res

属性 类型 默认值 必填 说明
path string 是 文件/目录路径 (本地路径)
recursive boolean 否 是否递归获取目录下的每个文件的 Stats 信息 默认值：false
complete function 否 接口调用结束的回调函数（调用成功、失败都会执行）
success function 否 接口调用成功的回调函数
fail function 否 接口调用失败的回调函数

object.success 回调参数

参数

Object res

属性 类型 说明
fileStatsList array 文件列表

object.fail 回调参数

参数

Object res

属性 类型 说明
errorMsg string 插件错误信息
errorCode string 错误码
innerError object 插件外部依赖错误信息 {errorMsg: string, errorCode: string }

函数定义示例

/**
 * 获取文件Stats对象，需要文件读写权限
 */
export function stat(params: {
  /** 文件/目录路径 (本地路径) */
  path: string;
  /**
   * 是否递归获取目录下的每个文件的 Stats 信息
   * 默认值：false
   */
  recursive?: boolean;
  /** 接口调用结束的回调函数（调用成功、失败都会执行） */
  complete?: () => void;
  /** 接口调用成功的回调函数 */
  success?: (params: {
    /** 文件列表 */
    fileStatsList: FileStats[];
  }) => void;
  /** 接口调用失败的回调函数 */
  fail?: (params: {
    errorMsg: string;
    errorCode: string | number;
    innerError: {
      errorCode: string | number;
      errorMsg: string;
    };
  }) => void;
}): void;

FileSystemManager.statSync

获取文件 Stats 对象同步方法，需要文件读写权限

参数

Object object

获取文件 Stats 对象，需要文件读写权限的回调函数

回调参数 Object res

属性 类型 默认值 必填 说明
fileId string 是 taskId
path string 是 文件/目录路径 (本地路径)
recursive boolean 否 是否递归获取目录下的每个文件的 Stats 信息 默认值：false

返回值

属性 类型 说明
fileStatsList array 文件列表

函数定义示例

/**
 * 获取文件Stats对象，需要文件读写权限
 */
export function statSync(params: {
  /** taskId */
  fileId: string;
  /** 文件/目录路径 (本地路径) */
  path: string;
  /**
   * 是否递归获取目录下的每个文件的 Stats 信息
   * 默认值：false
   */
  recursive?: boolean;
}): {
  /** 文件列表 */
  fileStatsList: FileStats[];
};

FileSystemManager.writeFile

写文件，需要文件读写权限

参数

Object object

写文件，需要文件读写权限的回调函数

回调参数 Object res

属性 类型 默认值 必填 说明
filePath string 是 要写入的文件路径 (本地路径)
data string 是 要写入的文本数据, 根据 encoding 编码
encoding string 否 指定写入文件的字符编码,目前支持【utf8、ascii、base64】, 默认 utf8
complete function 否 接口调用结束的回调函数（调用成功、失败都会执行）
success function 否 接口调用成功的回调函数
fail function 否 接口调用失败的回调函数

函数定义示例

/**
 * 写文件，需要文件读写权限
 */
export function writeFile(params: {
  /** 要写入的文件路径 (本地路径) */
  filePath: string;
  /** 要写入的文本数据, 根据encoding编码 */
  data: string;
  /** 指定写入文件的字符编码,目前支持【utf8、ascii、base64】, 默认utf8 */
  encoding?: string;
  /** 接口调用结束的回调函数（调用成功、失败都会执行） */
  complete?: () => void;
  /** 接口调用成功的回调函数 */
  success?: (params: null) => void;
  /** 接口调用失败的回调函数 */
  fail?: (params: {
    errorMsg: string;
    errorCode: string | number;
    innerError: {
      errorCode: string | number;
      errorMsg: string;
    };
  }) => void;
}): void;

FileSystemManager.writeFileSync

写文件同步方法，需要文件读写权限

参数

Object object

写文件，需要文件读写权限的回调函数

回调参数 Object res

属性 类型 默认值 必填 说明
fileId string 是 taskId
filePath string 是 要写入的文件路径 (本地路径)
data string 是 要写入的文本数据, 根据 encoding 编码
encoding string 否 指定写入文件的字符编码,目前支持【utf8、ascii、base64】, 默认 utf8

函数定义示例

/**
 * 写文件，需要文件读写权限
 */
export function writeFileSync(params: {
  /** taskId */
  fileId: string;
  /** 要写入的文件路径 (本地路径) */
  filePath: string;
  /** 要写入的文本数据, 根据encoding编码 */
  data: string;
  /** 指定写入文件的字符编码,目前支持【utf8、ascii、base64】, 默认utf8 */
  encoding?: string;
}): null;

👉 立即开发。

ty.getFileSystemManager

获取全局唯一的文件管理器。

参数

Object object

获取文件管理器的回调函数

回调参数 Object res

属性 类型 默认值 必填 说明
complete function 否 接口调用结束的回调函数（调用成功、失败都会执行）
success function 否 接口调用成功的回调函数
fail function 否 接口调用失败的回调函数

object.success 回调参数

参数

Object res

object.fail 回调参数

参数

Object res

属性 类型 说明
errorMsg string 插件错误信息
errorCode string 错误码
innerError object 插件外部依赖错误信息 {errorMsg: string, errorCode: string }

返回值

FileSystemManager

文件管理器

相关推荐
迷雾漫步者1 小时前
Flutter组件————FloatingActionButton
前端·flutter·dart
向前看-2 小时前
验证码机制
前端·后端
燃先生._.3 小时前
Day-03 Vue（生命周期、生命周期钩子八个函数、工程化开发和脚手架、组件化开发、根组件、局部注册和全局注册的步骤）
前端·javascript·vue.js
高山我梦口香糖4 小时前
[react]searchParams转普通对象
开发语言·前端·javascript
m0_748235244 小时前
前端实现获取后端返回的文件流并下载
前端·状态模式
郭wes代码4 小时前
Cmd命令大全（万字详细版）
python·算法·小程序
m0_748240255 小时前
前端如何检测用户登录状态是否过期
前端
black^sugar5 小时前
纯前端实现更新检测
开发语言·前端·javascript
寻找沙漠的人5 小时前
前端知识补充—CSS
前端·css
热门推荐
01〔AI 绘画〕Stable Diffusion 之 解决绘制多人或面部很小的人物时面部崩坏问题 篇02ARM学习（31）编译器对overlay方式的支持03玄机平台应急响应—webshell查杀04DisplayPort AltMode On Type-c协议_Ver2.0(学习笔记)05校验 GPT-4 真实性的三个经典问题：快速区分 GPT-3.5 与 GPT-4，并提供免费测试网站06Docker 夺命连环 15 问076个主流的工业3D管道设计软件08基于大语言模型（LLM）的合成数据生成、策展和评估的综述09(欧拉)openEuler系统添加网卡文件配置流程、(欧拉)openEuler系统手动配置ipv6地址流程、(欧拉)openEuler系统网络管理说明10树莓派 5 AI 套件（Hailo-8L）使用教程