數據標簽

該模塊提供文件數據安全等級的相關功能：向應用程序提供查詢、設置文件數據安全等級的JS接口。

說明： 本模塊首批接口從API version 9開始支持。后續版本的新增接口，采用上角標單獨標記接口的起始版本。 開發前請熟悉鴻蒙開發指導文檔 ：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]

導入模塊

import securityLabel from '@ohos.securityLabel';

使用說明

使用該功能模塊對文件/目錄進行操作前，需要先獲取其應用沙箱路徑，獲取方式及其接口用法請參考：

import featureAbility from '@ohos.ability.featureAbility';
let context = featureAbility.getContext();
let path = '';
context.getFilesDir().then((data) = > {
    path = data;
})

securityLabel.setSecurityLabel

setSecurityLabel(path:string, type:dataLevel):Promise

以異步方法設置數據標簽，以promise形式返回結果。

系統能力 ：SystemCapability.FileManagement.File.FileIO

參數：

返回值：

示例：

let type = "s4";
securityLabel.setSecurityLabel(path, type).then(function(){
    console.info("setSecurityLabel successfully");
}).catch(function(error){
    console.info("setSecurityLabel failed with error:" + error);
});

securityLabel.setSecurityLabel

setSecurityLabel(path:string, type:dataLevel, callback: AsyncCallback):void

以異步方法設置數據標簽，以callback形式返回結果。

系統能力 ：SystemCapability.FileManagement.File.FileIO

參數：

示例：

let type = "s4";
securityLabel.setSecurityLabel(path, type, function(error){
    console.info("setSecurityLabel:" + JSON.stringify(error));
});

securityLabel.setSecurityLabelSync

setSecurityLabelSync(path:string, type:dataLevel):void

以同步方法設置數據標簽。

系統能力 ：SystemCapability.FileManagement.File.FileIO

參數：

示例：

let type = "s4";
securityLabel.setSecurityLabelSync(path, type);

securityLabel.getSecurityLabel

getSecurityLabel(path:string):Promise

異步方法獲取數據標簽，以promise形式返回結果。

系統能力 ：SystemCapability.FileManagement.File.FileIO

參數：

返回值：

示例：

let type = "s4";
securityLabel.getSecurityLabel(path).then(function(type){
    console.log("getSecurityLabel successfully:" + type);
}).catch(function(error){
    console.log("getSecurityLabel failed with error:" + error);
});

securityLabel.getSecurityLabel

getSecurityLabel(path:string, callback:AsyncCallback): void

異步方法獲取數據標簽，以callback形式返回結果。

系統能力 ：SystemCapability.FileManagement.File.FileIO

參數：

示例：

let type = "s4";
securityLabel.getSecurityLabel(path,function(error, type){
    console.log("getSecurityLabel successfully:" + type);
});

securityLabel.getSecurityLabelSync

getSecurityLabelSync(path:string):string

以同步方法獲取數據標簽。

系統能力 ：SystemCapability.FileManagement.File.FileIO

參數：

返回值：

示例：

let result = securityLabel.getSecurityLabelSync(path);
console.log("getSecurityLabel successfully:" + result);

審核編輯 黃宇