创建智能小程序。
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
文件管理器