目录环境能力

icon-note.gif 说明:

  • 本模块首批接口从API version 8开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
  • 本模块接口为系统接口,三方应用不支持调用。

该模块提供环境目录能力,获取内存存储根目录、公共文件根目录的JS接口。

导入模块

import environment from '@ohos.environment';

environment.getStorageDataDir

getStorageDataDir():Promise<string>

异步方法获取内存存储根目录,以promise形式返回结果。

系统能力:SystemCapability.FileManagement.File.Environment

  • 返回值:
类型 说明
Promise<string> 返回存存储根目录
  • 示例:

    environment.getStorageDataDir().then(function(path){
        console.info("getStorageDataDir successfully:"+ path);
    }).catch(function(error){
        console.info("getStorageDataDir failed with error:"+ error);
    });
    

environment.getStorageDataDir

getStorageDataDir(callback:AsyncCallback<string>):void

异步方法获取内存存储根目录,以callback形式返回结果。

系统能力:SystemCapability.FileManagement.File.Environment

  • 参数:
参数名 类型 必填 说明
callback AsyncCallback<string> 异步获取内存存储根目录之后的回调
  • 示例:

    environment.getStorageDataDir(function(error, path){
        // do something
    });
    

environment.getUserDataDir

getUserDataDir():Promise<string>

异步方法获取公共文件根目录,以promise形式返回结果。

系统能力:SystemCapability.FileManagement.File.Environment

  • 返回值:
类型 说明
Promise<string> 返回公共文件根目录
  • 示例:

    environment.getUserDataDir().then(function(path){
        console.info("getUserDataDir successfully:"+ path);
    }).catch(function(error){
        console.info("getUserDataDir failed with error:"+ error);
    });
    

environment.getUserDataDir

getUserDataDir(callback:AsyncCallback<string>): void

异步方法获取公共文件根目录,以callback形式返回结果。

系统能力:SystemCapability.FileManagement.File.Environment

  • 参数:
参数名 类型 必填 说明
callback AsyncCallback<string> 异步获取公共文件根目录之后的回调
  • 示例:

    environment.getUserDataDir(function(error, path){
        // do something
    });