@ohos.file.fileuri (文件URI)

该模块提供通过PATH获取文件统一资源标志符（Uniform Resource Identifier，URI），后续可通过使用@ohos.file.fs进行相关open、read、write等操作，实现文件分享。

说明：

本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。

导入模块

import fileUri from "@ohos.file.fileuri";

使用该功能模块前，需要先获取其应用沙箱路径，开发示例如下：

import UIAbility from '@ohos.app.ability.UIAbility';
import window from '@ohos.window';

export default class EntryAbility extends UIAbility {
  onWindowStageCreate(windowStage: window.WindowStage) {
    let context = this.context;
    let pathDir = context.filesDir;
  }
}

FileUri¹⁰⁺

属性

系统能力：SystemCapability.FileManagement.AppFileService

constructor¹⁰⁺

constructor(uriOrPath: string)

constructor是FileUri的构造函数。

系统能力： SystemCapability.FileManagement.AppFileService

参数：

错误码：

以下错误码的详细介绍请参见文件管理子系统错误码。

示例：

let path = pathDir + '/test';
let uri = fileUri.getUriFromPath(path);  // file://<packageName>/data/storage/el2/base/haps/entry/files/test
let fileUriObject = new fileUri.FileUri(uri);
console.info("The name of FileUri is " + fileUriObject.name);

toString¹⁰⁺

toString(): string

系统能力： SystemCapability.FileManagement.AppFileService

返回字符串类型URI。

返回值：

示例：

let path = pathDir + '/test';
let fileUriObject = new fileUri.FileUri(path);
console.info("The uri of FileUri is " + fileUriObject.toString());

getFullDirectoryUri¹¹⁺

getFullDirectoryUri(): string

通过文件或文件夹URI获取当前所在路径的URI。

如果当前FileUri指向文件，将返回文件所在路径URI。如xxx/example.txt，将返回xxx。

如果当前FileUri指向目录，将返回当前路径URI。

系统能力：SystemCapability.FileManagement.AppFileService

返回值：

错误码：

以下错误码的详细介绍请参见文件管理子系统错误码。

示例：

import { BusinessError } from '@ohos.base';
try {
  let path = pathDir + '/test.txt';
  let fileUriObject = new fileUri.FileUri(path);
  let directoryUri = fileUriObject.getFullDirectoryUri();
  console.log(`success to getFullDirectoryUri: ${JSON.stringify(directoryUri)}`);
} catch (error) {
  console.error(`failed to getFullDirectoryUri because: ${JSON.stringify(error)}`);
}

fileUri.getUriFromPath

getUriFromPath(path: string): string

以同步方法获取文件URI。

系统能力：SystemCapability.FileManagement.AppFileService

参数：

返回值：

错误码：

以下错误码的详细介绍请参见通用错误码。

示例：

let filePath = pathDir + "/test";
let uri = fileUri.getUriFromPath(filePath);