@ohos.app.ability.dataUriUtils (DataUriUtils)
The DataUriUtils module provides APIs to process URI objects. You can use the APIs to attach an ID to the end of a given URI and obtain, delete, or update the ID attached to the end of a given URI.
NOTE
The initial APIs of this module are supported since API version 9. Newly added APIs will be marked with a superscript to indicate their earliest API version.
Modules to Import
import dataUriUtils from '@ohos.app.ability.dataUriUtils';
dataUriUtils.getId
getId(uri: string): number
Obtains the ID attached to the end of a given URI.
System capability: SystemCapability.Ability.AbilityRuntime.Core
Parameters
Name | Type | Mandatory | Description |
---|---|---|---|
uri | string | Yes | Target URI object. |
Return value
Type | Description |
---|---|
number | ID obtained. |
Example
try {
let id = dataUriUtils.getId('com.example.dataUriUtils/1221');
console.info('get id: ${id}');
} catch(err) {
console.error('get id err ,check the uri ${err}');
}
dataUriUtils.attachId
attachId(uri: string, id: number): string
Attaches an ID to the end of a given URI.
System capability: SystemCapability.Ability.AbilityRuntime.Core
Parameters
Name | Type | Mandatory | Description |
---|---|---|---|
uri | string | Yes | Target URI object. |
id | number | Yes | ID to be attached. |
Return value
Type | Description |
---|---|
string | URI object with the ID attached. |
Example
let id = 1122;
try {
let uri = dataUriUtils.attachId(
'com.example.dataUriUtils',
id,
);
console.info('attachId the uri is: ${uri}');
} catch (err) {
console.error('get id err ,check the uri ${err}');
}
dataUriUtils.deleteId
deleteId(uri: string): string
Deletes the ID from the end of a given URI.
System capability: SystemCapability.Ability.AbilityRuntime.Core
Parameters
Name | Type | Mandatory | Description |
---|---|---|---|
uri | string | Yes | URI object from which the ID is to be deleted. |
Return value
Type | Description |
---|---|
string | URI object with the ID deleted. |
Example
try {
let uri = dataUriUtils.deleteId('com.example.dataUriUtils/1221');
console.info('delete id with the uri is: ${uri}');
} catch(err) {
console.error('delete uri err, check the input uri ${err}');
}
dataUriUtils.updateId
updateId(uri: string, id: number): string
Updates the ID in a given URI.
System capability: SystemCapability.Ability.AbilityRuntime.Core
Parameters
Name | Type | Mandatory | Description |
---|---|---|---|
uri | string | Yes | Target URI object. |
id | number | Yes | New ID. |
Return value
Type | Description |
---|---|
string | URI object with the new ID. |
Example
try {
let id = 1122;
let uri = dataUriUtils.updateId(
'com.example.dataUriUtils/1221',
id
);
} catch (err) {
console.error('delete uri err, check the input uri ${err}');
}