diff --git a/en/application-dev/reference/apis/js-apis-userFileManager.md b/en/application-dev/reference/apis/js-apis-userFileManager.md index 4de8727e244f81858ca14137197ca676c0a2c792..c783b02f46c014a12ddba60432e1fe182cb93b42 100644 --- a/en/application-dev/reference/apis/js-apis-userFileManager.md +++ b/en/application-dev/reference/apis/js-apis-userFileManager.md @@ -83,10 +83,10 @@ async function example() { console.info('fetchResult success'); let fileAsset = await fetchResult.getFirstObject(); if (fileAsset != undefined) { - console.info("fileAsset.displayName :" + fileAsset.displayName); + console.info("fileAsset.displayName : " + fileAsset.displayName); } } else { - console.info('fetchResult fail' + err); + console.error('fetchResult fail' + err); } }); } @@ -137,7 +137,7 @@ async function example() { } } } catch (err) { - console.info('getPhotoAssets failed, message = ', err); + console.error('getPhotoAssets failed, message = ', err); } } ``` @@ -178,7 +178,7 @@ async function example() { console.info('createPhotoAsset file displayName' + fileAsset.displayName); console.info('createPhotoAsset successfully'); } else { - console.info('createPhotoAsset failed, message = ', err); + console.error('createPhotoAsset failed, message = ', err); } }); } @@ -212,7 +212,7 @@ async function example() { console.info('createPhotoAsset file displayName' + fileAsset.displayName); console.info('createPhotoAsset successfully'); } else { - console.info('createPhotoAsset failed, message = ', err); + console.error('createPhotoAsset failed, message = ', err); } }); } @@ -252,7 +252,7 @@ async function example() { console.info('createPhotoAsset file displayName' + fileAsset.displayName); console.info('createPhotoAsset successfully'); } catch (err) { - console.info('createPhotoAsset failed, message = ', err); + console.error('createPhotoAsset failed, message = ', err); } } ``` @@ -294,11 +294,11 @@ async function example() { if (album != undefined) { console.info('first album.albumName = ' + album.albumName); } else { - console.info('album is undefined, err = ', err); + console.error('album is undefined, err = ', err); } }); } else { - console.info('getPhotoAlbums fail, message = ', err); + console.error('getPhotoAlbums fail, message = ', err); } }); } @@ -343,7 +343,7 @@ async function example() { const album = await fetchResult.getFirstObject(); console.info('first album.albumName = ' + album.albumName); } catch (err) { - console.info('getPhotoAlbums fail, message = ' + err); + console.error('getPhotoAlbums fail, message = ' + err); } } ``` @@ -376,7 +376,7 @@ async function example() { let trashAlbum = await fetchResult.getFirstObject(); console.info('first album.albumName = ' + trashAlbum.albumName); } else { - console.info('getPrivateAlbum failed. message = ', err); + console.error('getPrivateAlbum failed. message = ', err); } }); } @@ -415,7 +415,7 @@ async function example() { let trashAlbum = await fetchResult.getFirstObject(); console.info('first album.albumName = ' + trashAlbum.albumName); } catch (err) { - console.info('getPrivateAlbum failed. message = ', err); + console.error('getPrivateAlbum failed. message = ', err); } } ``` @@ -459,7 +459,7 @@ async function example() { console.info("fileAsset.displayName :" + fileAsset.displayName); } } else { - console.info('fetchFileResult fail' + err); + console.error('fetchFileResult fail' + err); } }); } @@ -503,7 +503,7 @@ async function example() { try { var fetchResult = await mgr.getAudioAssets(fetchOptions); } catch (err) { - console.info('getAudioAssets failed, message = ', err); + console.error('getAudioAssets failed, message = ', err); } if (fetchResult != undefined) { @@ -559,7 +559,7 @@ async function example() { if (err == undefined) { console.info("delete successfully"); } else { - console.info("delete failed with error:" + err); + console.error("delete failed with error: " + err); } }); } @@ -613,7 +613,7 @@ async function example() { await mgr.delete(asset.uri); console.info("delete successfully"); } catch (err) { - console.info("delete failed with error:" + err); + console.error("delete failed with error: " + err); } } ``` @@ -649,13 +649,13 @@ async function example() { console.info('createPhotoAsset file displayName' + fileAsset.displayName); console.info('createPhotoAsset successfully'); } catch (err) { - console.info('createPhotoAsset failed, message = ' + err); + console.error('createPhotoAsset failed, message = ' + err); } //sleep 1s if (count > 0) { console.info("onDemo success"); } else { - console.info("onDemo fail"); + console.error("onDemo fail"); } mgr.off('imageChange', () => { // Unsubscription succeeds. @@ -699,13 +699,13 @@ async function example() { console.info('createPhotoAsset file displayName' + fileAsset.displayName); console.info('createPhotoAsset successfully'); } catch (err) { - console.info('createPhotoAsset failed, message = ' + err); + console.error('createPhotoAsset failed, message = ' + err); } //sleep 1s if (count == 0) { console.info("offDemo success"); } else { - console.info("offDemo fail"); + console.error("offDemo fail"); } } ``` @@ -736,7 +736,7 @@ async function example() { console.info('get distributed info ' + devicesInfo[i].deviceName + devicesInfo[i].networkId); } } else { - console.info('getActivePeers failed. message = ', err); + console.error('getActivePeers failed. message = ', err); } }); } @@ -764,7 +764,7 @@ async function example() { try { var devicesInfo = await mgr.getActivePeers(); } catch (err) { - console.info('getActivePeers failed. message = ', err); + console.error('getActivePeers failed. message = ', err); } if (devicesInfo != undefined) { console.log('getActivePeers succeed.'); @@ -772,7 +772,7 @@ async function example() { console.info('get distributed info ' + devicesInfo[i].deviceName + devicesInfo[i].networkId); } } else { - console.info('get distributed fail'); + console.error('get distributed fail'); } } ``` @@ -803,7 +803,7 @@ async function example() { console.info('get distributed info ' + devicesInfo[i].deviceName + devicesInfo[i].networkId); } } else { - console.info('getAllPeers failed. message = ', err); + console.error('getAllPeers failed. message = ', err); } }); } @@ -831,7 +831,7 @@ async function example() { try { var devicesInfo = await mgr.getAllPeers(); } catch (err) { - console.info('getAllPeers failed. message = ', err); + console.error('getAllPeers failed. message = ', err); } if (devicesInfo != undefined) { console.log('getAllPeers succeed.'); @@ -839,7 +839,7 @@ async function example() { console.info('get distributed info ' + devicesInfo[i].deviceName + devicesInfo[i].networkId); } } else { - console.info('get distributed fail'); + console.error('get distributed fail'); } } ``` @@ -866,7 +866,7 @@ async function example() { console.info('releaseDemo'); mgr.release((err) => { if (err != undefined) { - console.info('release failed. message = ', err); + console.error('release failed. message = ', err); } else { console.info('release ok.'); } @@ -898,7 +898,7 @@ async function example() { await mgr.release(); console.info('release ok.'); } catch (err) { - console.info('release failed. message = ', err); + console.error('release failed. message = ', err); } } ``` @@ -951,7 +951,7 @@ async function example() { let fileAssetTitle = fileAsset.get(title.toString()); console.info('fileAsset Get fileAssetTitle = ', fileAssetTitle); } catch (err) { - console.info('release failed. message = ', err); + console.error('release failed. message = ', err); } } ``` @@ -989,7 +989,7 @@ async function example() { let title = userFileManager.ImageVideoKey.TITLE; fileAsset.set(title.toString(), "newTitle"); } catch (err) { - console.info('release failed. message = ', err); + console.error('release failed. message = ', err); } } ``` @@ -1033,7 +1033,7 @@ async function example() { let newFileAssetTitle = fileAsset.get(title.toString()); console.info('fileAsset Get newFileAssetTitle = ', newFileAssetTitle); } else { - console.info('commitModify failed, message =', err); + console.error('commitModify failed, message =', err); } }); } @@ -1078,7 +1078,7 @@ async function example() { let newFileAssetTitle = fileAsset.get(title.toString()); console.info('fileAsset Get newFileAssetTitle = ', newFileAssetTitle); } catch (err) { - console.info('release failed. message = ', err); + console.error('release failed. message = ', err); } } ``` @@ -1089,9 +1089,7 @@ open(mode: string, callback: AsyncCallback<number>): void Opens this file asset. This API uses an asynchronous callback to return the result. ->**NOTE** -> ->The write operations are mutually exclusive. After a write operation is complete, you must call **close** to release the resource. +**NOTE**
The write operations are mutually exclusive. After a write operation is complete, you must call **close** to release the resource. **Required permissions**: ohos.permission.READ_IMAGEVIDEO, ohos.permission.READ_AUDIO, ohos.permission.WRITE_IMAGEVIDEO, or ohos.permission.WRITE_AUDIO @@ -1103,7 +1101,7 @@ Opens this file asset. This API uses an asynchronous callback to return the resu | Name | Type | Mandatory | Description | | -------- | --------------------------- | ---- | ----------------------------------- | | mode | string | Yes | File open mode, which can be **r** (read-only), **w** (write-only), or **rw** (read-write).| -| callback | AsyncCallback<number> | Yes | Callback used to return the file handle. | +| callback | AsyncCallback<number> | Yes | Callback invoked to return the file descriptor. | **Example** @@ -1117,7 +1115,7 @@ async function example() { console.info('File fd' + fd); fileAsset.close(fd); } else { - console.info('File err' + err); + console.error('File err' + err); } }); } @@ -1129,9 +1127,7 @@ open(mode: string): Promise<number> Opens this file asset. This API uses a promise to return the result. ->**NOTE** -> ->The write operations are mutually exclusive. After a write operation is complete, you must call **close** to release the resource. +**NOTE**
The write operations are mutually exclusive. After a write operation is complete, you must call **close** to release the resource. **Required permissions**: ohos.permission.READ_IMAGEVIDEO, ohos.permission.READ_AUDIO, ohos.permission.WRITE_IMAGEVIDEO, or ohos.permission.WRITE_AUDIO @@ -1147,7 +1143,7 @@ Opens this file asset. This API uses a promise to return the result. | Type | Description | | --------------------- | ------------- | -| Promise<number> | Promise used to return the file handle.| +| Promise<number> | Promise used to return the file descriptor.| **Example** @@ -1162,10 +1158,10 @@ async function example() { console.info('File fd' + fd); fileAsset.close(fd); } else { - console.info(' open File fail'); + console.error(' open File fail'); } } catch (err) { - console.info('open Demo err' + err); + console.error('open Demo err' + err); } } ``` @@ -1206,11 +1202,11 @@ async function example() { if (err == undefined) { console.info('asset close succeed.'); } else { - console.info('close failed, message = ' + err); + console.error('close failed, message = ' + err); } }); } catch (err) { - console.info('close failed, message = ' + err); + console.error('close failed, message = ' + err); } } ``` @@ -1255,7 +1251,7 @@ async function example() { await asset.close(fd); console.info('asset close succeed.'); } catch (err) { - console.info('close failed, message = ' + err); + console.error('close failed, message = ' + err); } } ``` @@ -1295,7 +1291,7 @@ async function example() { if (err == undefined) { console.info('getThumbnail successful ' + pixelMap); } else { - console.info('getThumbnail fail', err); + console.error('getThumbnail fail', err); } }); } @@ -1338,7 +1334,7 @@ async function example() { if (err == undefined) { console.info('getThumbnail successful ' + pixelMap); } else { - console.info('getThumbnail fail', err); + console.error('getThumbnail fail', err); } }); } @@ -1385,7 +1381,7 @@ async function example() { asset.getThumbnail(size).then((pixelMap) => { console.info('getThumbnail successful ' + pixelMap); }).catch((err) => { - console.info('getThumbnail fail' + err); + console.error('getThumbnail fail' + err); }); } ``` @@ -1425,7 +1421,7 @@ async function example() { if (err == undefined) { console.info("favorite successfully"); } else { - console.info("favorite failed with error:" + err); + console.error("favorite failed with error:" + err); } }); } @@ -1470,7 +1466,7 @@ async function example() { asset.favorite(true).then(function () { console.info("favorite successfully"); }).catch(function (err) { - console.info("favorite failed with error:" + err); + console.error("favorite failed with error:" + err); }); } ``` @@ -1573,7 +1569,7 @@ async function example() { await fetchResult.close(); console.info('close succeed.'); } catch (err) { - console.info('close fail. message = ' + err); + console.error('close fail. message = ' + err); } } ``` @@ -1609,7 +1605,7 @@ async function example() { if (fileAsset != undefined) { console.info('fileAsset displayName: ', fileAsset.displayName); } else { - console.info("fileAsset failed with err:" + err); + console.error("fileAsset failed with err:" + err); } }); } @@ -1680,7 +1676,7 @@ async function example() { if (fileAsset != undefined) { console.info('fileAsset displayName: ', fileAsset.displayName); } else { - console.info("fileAsset failed with err:" + err); + console.error("fileAsset failed with err: " + err); } }); } @@ -1753,7 +1749,7 @@ async function example() { if (fileAsset != undefined) { console.info('fileAsset displayName: ', fileAsset.displayName); } else { - console.info("fileAsset failed with err:" + err); + console.error("fileAsset failed with err: " + err); } }); } @@ -1823,7 +1819,7 @@ async function example() { if (fileAsset != undefined) { console.info('fileAsset displayName: ', fileAsset.displayName); } else { - console.info("fileAsset failed with err:" + err); + console.error("fileAsset failed with err: " + err); } }); } @@ -1920,9 +1916,9 @@ async function example() { const album = await albumList.getFirstObject(); album.getPhotoAssets(fetchOption, (err, albumFetchResult) => { if (albumFetchResult != undefined) { - console.info("album getPhotoAssets successfully, getCount:" + albumFetchResult.getCount()); + console.info("album getPhotoAssets successfully, getCount: " + albumFetchResult.getCount()); } else { - console.info("album getPhotoAssets failed with error:" + err); + console.error("album getPhotoAssets failed with error: " + err); } }); } @@ -1963,9 +1959,9 @@ async function example() { const albumList = await mgr.getPhotoAlbums(albumFetchOptions); const album = await albumList.getFirstObject(); album.getPhotoAssets(fetchOption).then((albumFetchResult) => { - console.info("album getFileAssets successfully, getCount:" + albumFetchResult.getCount()); + console.info("album getFileAssets successfully, getCount: " + albumFetchResult.getCount()); }).catch((err) => { - console.info("album getFileAssets failed with error:" + err); + console.error("album getFileAssets failed with error: " + err); }); } ``` @@ -2002,7 +1998,7 @@ async function example() { album.albumName = 'hello'; album.commitModify((err) => { if (err != undefined) { - console.info("commitModify failed with error:" + err); + console.error("commitModify failed with error: " + err); } else { console.info("commitModify successfully"); } @@ -2040,14 +2036,14 @@ async function example() { try { var albumList = await mgr.getPhotoAlbums(albumFetchOptions); } catch (err) { - console.info('getPhotoAlbums failed. message = ', err); + console.error('getPhotoAlbums failed. message = ', err); } const album = await albumList.getFirstObject(); album.albumName = 'hello'; album.commitModify().then(() => { console.info("commitModify successfully"); }).catch((err) => { - console.info("commitModify failed with error:" + err); + console.error("commitModify failed with error: " + err); }); } ``` @@ -2104,7 +2100,7 @@ async function example() { let count = fetchResult.getCount(); console.info('fetchResult.count = ', count); } else { - console.info('getFileAssets failed, message = ', err); + console.error('getFileAssets failed, message = ', err); } }); } @@ -2187,7 +2183,7 @@ async function example() { let deleteFileUri = fileAsset.uri; trashAlbum.delete(deleteFileUri, (err) => { if (err != undefined) { - console.info('trashAlbum.delete failed, message = ', err); + console.error('trashAlbum.delete failed, message = ', err); } else { console.info('trashAlbum.delete successfully'); } @@ -2236,7 +2232,7 @@ async function example() { trashAlbum.delete(deleteFileUri).then(() => { console.info('trashAlbum.delete successfully'); }).catch((err) => { - console.info('trashAlbum.delete failed, message = ', err); + console.error('trashAlbum.delete failed, message = ', err); }); } ``` @@ -2277,7 +2273,7 @@ async function example() { let recoverFileUri = fileAsset.uri; trashAlbum.recover(recoverFileUri, (err) => { if (err != undefined) { - console.info('trashAlbum.recover failed, message = ', err); + console.error('trashAlbum.recover failed, message = ', err); } else { console.info('trashAlbum.recover successfully'); } @@ -2326,7 +2322,7 @@ async function example() { trashAlbum.recover(recoverFileUri).then(() => { console.info('trashAlbum.recover successfully'); }).catch((err) => { - console.info('trashAlbum.recover failed, message = ', err); + console.error('trashAlbum.recover failed, message = ', err); }); } ``` @@ -2339,9 +2335,9 @@ Enumerates the member types. | Name | Type| Readable | Writable | Description | | ----- | ---- | ---- | ---- | ---- | -| number | number | Yes| Yes| The member is a number.| -| string | string | Yes| Yes| The member is a string.| -| boolean | boolean | Yes| Yes| The member is a Boolean value.| +| number | number | Yes| Yes| The member is a number.| +| string | string | Yes| Yes| The member is a string.| +| boolean | boolean | Yes| Yes| The member is a Boolean value.| ## ChangeEvent @@ -2407,7 +2403,7 @@ Defines the key information about an audio file. | URI | uri | File URI. | | DISPLAY_NAME | display_name | File name displayed. | | DATE_ADDED | date_added | Date when the file was added. The value is the number of seconds elapsed since the Epoch time. | -| DATE_MODIFIED | date_modified | Date when the file was last modified. The value is the number of seconds elapsed since the Epoch time. | +| DATE_MODIFIED | date_modified | Date when the file content (not the file name) was last modified. The value is the number of seconds elapsed since the Epoch time.| | TITLE | title | Title in the file. | | ARTIST | artist | Author of the file. | | AUDIOALBUM | audio_album | Audio album. | @@ -2426,7 +2422,7 @@ Defines the key information about an image or video file. | FILE_TYPE | file_type | Type of the file. | | DISPLAY_NAME | display_name | File name displayed. | | DATE_ADDED | date_added | Date when the file was added. The value is the number of seconds elapsed since the Epoch time. | -| DATE_MODIFIED | date_modified | Date when the file was last modified. The value is the number of seconds elapsed since the Epoch time. | +| DATE_MODIFIED | date_modified | Date when the file content (not the file name) was last modified. The value is the number of seconds elapsed since the Epoch time.| | TITLE | title | Title in the file. | | DURATION | duration | Duration, in ms. | | WIDTH | width | Image width, in pixels. | @@ -2447,7 +2443,7 @@ Defines the key album information. | FILE_TYPE | file_type | Type of the file. | | ALBUM_NAME | album_name | Name of the album. | | DATE_ADDED | date_added | Date when the file was added. The value is the number of seconds elapsed since the Epoch time. | -| DATE_MODIFIED | date_modified | Date when the file was last modified. The value is the number of seconds elapsed since the Epoch time. | +| DATE_MODIFIED | date_modified | Date when the file content (not the file name) was last modified. The value is the number of seconds elapsed since the Epoch time.| ## FetchOptions