apifs
readText
查看 Markdown从虚拟文件系统读取 UTF-8 文本，大文本返回临时文件句柄。
从虚拟文件系统读取 UTF-8 文本，大文本返回临时文件句柄。
KSM.fs.readText(args: {
path: string;
}): Promise<string | { file: string }>命名导出调用形式相同：fs.readText({ path })。
| Windows | Android | 权限 |
|---|---|---|
| 支持 | 支持 | fs.read |
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
path | string | 是 | 可读的 app:// 虚拟路径 |
string。{ file: string }，file 是 app://tmp/read-<id>.txt。app://res 和 app://assets 只读，但可以通过本方法读取。app://picked/<id> 必须是文件选择器登记过的 token。const result = await KSM.fs.readText({
path: 'app://data/large.txt'
});
if (typeof result === 'string') {
console.info(result);
} else {
const handleResult = await KSM.fs.readText({ path: result.file });
console.assert(
typeof handleResult === 'object' &&
handleResult.file === result.file
);
}| 错误 | 场景 |
|---|---|
普通 TypeError | 路径未通过前端守卫 |
PERMISSION_DENIED | 路径越出沙箱，或权限不可用 |
NOT_FOUND | 目标文件不存在 |
IO_ERROR | 文件存在但无法读取、超过 16 MiB 或临时句柄写入失败 |
NOT_SUPPORTED | 对应文件服务未配置 |
TIMEOUT | 宿主未在默认时间内响应 |
评论