!6401 【翻译完成】#I5EYJQ

Merge pull request !6401 from Annie_wang/PR6195

en/application-dev/reference/apis/js-apis-document.md

 # File Interaction
 
-> ![icon-note.gif](public_sys-resources/icon-note.gif) **NOTE**<br/>
-- The initial APIs of this module are supported since API version 6. Newly added APIs will be marked with a superscript to indicate their earliest API version.
-- The APIs of this module will be deprecated and are not recommended for use. An exception will be thrown if any of the APIs is called.
+> **NOTE**<br/>
+> - The initial APIs of this module are supported since API version 6. Newly added APIs will be marked with a superscript to indicate their earliest API version.
+> - The APIs of this module will be deprecated and are not recommended for use. An exception will be thrown if any of the APIs is called.
 
 ## Modules to Import
 
@@ -12,109 +12,115 @@ import document from '@ohos.document';
 
 ## document.choose
 
-choose(type:string[]): Promise&lt;string&gt;
+choose(types? : string[]): Promise&lt;string&gt;
 
-Chooses a file of the specified type using the file manager. This method uses a promise to return the result.
+Chooses a file of the specified type using the file manager. This API uses a promise to return the result.
 
-**System capability**: SystemCapability.FileManagement.File.FileIO
+**System capability**: SystemCapability.FileManagement.UserFileService
 
-- Parameters
+**Parameters**
 
   | Name| Type  | Mandatory| Description                        |
   | ------ | ------ | ---- | ---------------------------- |
-  | type   | string[] | No  | Type of the file to choose.|
+  | types   | string[] | No  | Type of the file to choose.|
 
-- Return value
+**Return value**
 
   | Type                 | Description          |
   | --------------------- | -------------- |
   | Promise&lt;string&gt; | Promise used to return the result. An error code is returned.|
 
-- Example
+**Example**
 
   ```js
-  await document.choose(type);
+  let types = [];
+  document.choose(types);
   ```
 ## document.choose
 
 choose(callback:AsyncCallback&lt;string&gt;): void
 
-Chooses a file using the file manager. This method uses an asynchronous callback to return the result.
+Chooses a file using the file manager. This API uses an asynchronous callback to return the result.
 
-**System capability**: SystemCapability.FileManagement.File.FileIO
+**System capability**: SystemCapability.FileManagement.UserFileService
 
-- Parameters
+**Parameters**
 
   | Name  | Type                       | Mandatory| Description                        |
   | -------- | --------------------------- | ---- | ---------------------------- |
   | callback | AsyncCallback&lt;string&gt; | Yes  | Callback used to return the result. An error code is returned.|
 
-- Example
+**Example**
 
   ```js
-  await document.choose(function(err, uri) {
+  let uri = "";
+  document.choose(function(err, uri) {
         // Do something with the URI. 
   });
   ```
 ## document.choose
 
-choose(type:string[], callback:AsyncCallback&lt;string&gt;): void
+choose(types:string[], callback:AsyncCallback&lt;string&gt;): void
 
-Chooses a file of the specified type using the file manager. This method uses an asynchronous callback to return the result.
+Chooses a file using the file manager. This API uses an asynchronous callback to return the result.
 
-**System capability**: SystemCapability.FileManagement.File.FileIO
+**System capability**: SystemCapability.FileManagement.UserFileService
 
-- Parameters
+**Parameters**
 
   | Name  | Type                       | Mandatory| Description                        |
   | -------- | --------------------------- | ---- | ---------------------------- |
-  | type     | string[]                      | No  | Type of the file to choose.|
+  | types    | string[]                      | No  | Type of the file to choose.|
   | callback | AsyncCallback&lt;string&gt; | Yes  | Callback used to return the result. An error code is returned.|
 
-- Example
+**Example**
 
   ```js
-  await document.choose(type, function(err, uri) {
+  let types = [];
+  let uri = "";
+  document.choose(types, function(err, uri) {
         // Do something with the URI. 
   });
   ```
 
 ## document.show
 
-show(url:string, type:string):Promise&lt;number&gt;
+show(uri:string, type:string):Promise&lt;void&gt;
 
-Opens a file. This method uses a promise to return the result.
+Opens a file. This API uses a promise to return the result.
 
-**System capability**: SystemCapability.FileManagement.File.FileIO
+**System capability**: SystemCapability.FileManagement.UserFileService
 
-- Parameters
+**Parameters**
 
   | Name| Type  | Mandatory| Description                        |
   | ---- | ------ | ---- | ---------------------------- |
   | uri | string | Yes  | URI of the file to open.|
   | type | string | Yes  | Type of the file to open.|
 
-- Return value
+**Return value**
 
   | Type                 | Description        |
   | --------------------- | ------------ |
   | Promise&lt;void&gt; | Promise used to return the result. An error code is returned.|
 
-- Example
+**Example**
 
   ```js
-  await document.show(uri, type);
+  let type = "";
+  let uri = "";
+  document.show(uri, type);
   ```
 
 ## document.show
 
-show(url:string, type:string, callback:AsyncCallback&lt;void&gt;): void
+show(uri:string, type:string, callback:AsyncCallback&lt;void&gt;): void
 
-Opens a file. This method uses an asynchronous callback to return the result.
+Opens a file. This API uses an asynchronous callback to return the result.
 
-**System capability**: SystemCapability.FileManagement.File.FileIO
+**System capability**: SystemCapability.FileManagement.UserFileService
 
-- Parameters
+**Parameters**
 
   | Name  | Type                       | Mandatory| Description                        |
   | -------- | --------------------------- | ---- | ---------------------------- |
@@ -122,10 +128,12 @@ Opens a file. This method uses an asynchronous callback to return the result.
   | type | string | Yes  | Type of the file to open.|
   | callback | AsyncCallback&lt;void&gt; | Yes  | Callback used to return the result. An error code is returned.  |
 
-- Example
+**Example**
 
   ```js
-  await document.show(uri, type, function(err) {
+  let type = "";
+  let uri = "";
+  document.show(uri, type, function(err) {
         //do something
   });
   ```

en/application-dev/reference/apis/js-apis-securityLabel.md

+# Security Label
+
+> **NOTE**<br/>
+> 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.
+
+Manages file data security levels, including obtaining and setting file data security levels.
+
+## Modules to Import
+
+```js
+import securityLabel from '@ohos.securityLabel';
+```
+
+## Usage
+
+Before using the APIs provided by this module to perform operations on a file or directory, obtain the path of the application sandbox. For details, see [getOrCreateLocalDir of the Context module](js-apis-Context.md).
+
+```js
+import featureAbility from '@ohos.ability.featureAbility';
+let context = featureAbility.getContext();
+let path = context.getFilesDir();
+```
+
+## securityLabel.setSecurityLabel
+
+setSecurityLabel(path:string, type:dataLevel):Promise&lt;void&gt;
+
+Sets the security label for a file in asynchronous mode. This API uses a promise to return the result.
+
+**System capability**: SystemCapability.FileManagement.File.FileIO
+
+**Parameters**
+
+| Name   | Type      | Mandatory| Description                                        |
+| --------- | ------    | ---- | -------------------------------------------- |
+| path      | string    | Yes  | File path.                                    |
+| type      | dataLevel | Yes  | File security level, which can be **s0**, **s1**, **s2**, **s3**, or **s4**.|
+
+**Return value**
+
+  | Type               | Description            |
+  | ------------------- | ---------------- |
+  | Promise&lt;void&gt; | Promise used to return the result. An empty value will be returned.|
+
+**Example**
+
+  ```js
+  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&lt;void&gt;):void
+
+Sets the security label for a file in asynchronous mode. This API uses a callback to return the result.
+
+**System capability**: SystemCapability.FileManagement.File.FileIO
+
+**Parameters**
+
+| Name   | Type                     | Mandatory| Description                                        |
+| --------- | ------------------------- | ---- | -------------------------------------------- |
+| path      | string                    | Yes  | File path.                                    |
+| type      | dataLevel                 | Yes  | File security level, which can be **s0**, **s1**, **s2**, **s3**, or **s4**.|
+| callback  | AsyncCallback&lt;void&gt; | Yes  | Callback used to return the result.                  |
+
+**Example**
+
+  ```js
+  let type = "s4";
+  securityLabel.setSecurityLabel(path, type, function(error){
+      console.info("setSecurityLabel:" + JSON.stringify(error));
+  });
+  ```
+## securityLabel.setSecurityLabelSync
+
+setSecurityLabelSync(path:string, type:dataLevel):void
+
+Sets the security label for a file in synchronous mode.
+
+**System capability**: SystemCapability.FileManagement.File.FileIO
+
+**Parameters**
+
+| Name   | Type  | Mandatory| Description                                        |
+| --------- | ------ | ---- | -------------------------------------------- |
+| path      | string | Yes  | File path.                                    |
+| type      | dataLevel | Yes  | File security level, which can be **s0**, **s1**, **s2**, **s3**, or **s4**.|
+
+**Example**
+
+```js
+let type = "s4";
+securityLabel.setSecurityLabelSync(path, type);
+```
+
+## securityLabel.getSecurityLabel
+
+getSecurityLabel(path:string):Promise&lt;string&gt;
+
+Obtains the security label of a file in asynchronous mode. This API uses a promise to return the result.
+
+**System capability**: SystemCapability.FileManagement.File.FileIO
+
+**Parameters**
+
+  | Name| Type  | Mandatory| Description    |
+  | ------ | ------ | ---- | -------- |
+  | path   | string | Yes  | File path.|
+
+**Return value**
+
+  | Type                 | Description        |
+  | --------------------- | ------------ |
+  | Promise&lt;string&gt; | Promise used to return the security label obtained.|
+
+**Example**
+
+  ```js
+  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&lt;string&gt;): void
+
+Obtains the security label of a file in asynchronous mode. This API uses a callback to return the result.
+
+**System capability**: SystemCapability.FileManagement.File.FileIO
+
+**Parameters**
+
+  | Name  | Type                       | Mandatory| Description                      |
+  | -------- | --------------------------- | ---- | -------------------------- |
+  | path     | string                      | Yes  | File path.                  |
+  | callback | AsyncCallback&lt;string&gt; | Yes  | Callback used to return the security label obtained.|
+
+**Example**
+
+  ```js
+  let type = "s4";
+  securityLabel.getSecurityLabel(path,function(error, type){
+      console.log("getSecurityLabel successfully:" + type);
+  });
+  ```
+## securityLabel.getSecurityLabelSync
+
+getSecurityLabelSync(path:string):string
+
+Obtains the security label of a file in synchronous mode.
+
+**System capability**: SystemCapability.FileManagement.File.FileIO
+
+**Parameters**
+
+| Name| Type  | Mandatory| Description    |
+| ------ | ------ | ---- | -------- |
+| path   | string | Yes  | File path.|
+
+**Return value**
+
+| Type  | Description        |
+| ------ | ------------ |
+| string | Security label obtained.|
+
+**Example**
+
+```js
+let result = securityLabel.getSecurityLabelSync(path);
+console.log("getSecurityLabel successfully:" + result);
+```

en/application-dev/reference/apis/js-apis-storage-statistics.md

@@ -4,99 +4,114 @@
 >
 > - The initial APIs of this module are supported since API version 8. Newly added APIs will be marked with a superscript to indicate their earliest API version.
 > - API version 9 is a canary version for trial use. The APIs of this version may be unstable.
-> - The APIs of this module are system APIs and cannot be called by third-party applications.
 
-This module provides functions to obtain storage statistics, including the space of built-in and plug-in memory cards, statistics of application data by type, and application data.
+Obtains storage space information, including the space of built-in and plug-in memory cards, space occupied by different types of data, and space of application data.
 
 ## Modules to Import
 
 ```js
-import storagestatistics from "@ohos.storageStatistics";
+import storageStatistics from "@ohos.storageStatistics";
 ```
 
-## storagestatistics.getTotalSizeOfVolume
+## storageStatistics.getTotalSizeOfVolume
 
 getTotalSizeOfVolume(volumeUuid: string): Promise<number>
 
-Asynchronously obtains the total space of the specified volume. This API uses a promise to return the result.
+Asynchronously obtains the total size of the specified volume. This API uses a promise to return the result.
+
+**Required permissions**: ohos.permission.STORAGE_MANAGER
 
 **System capability**: SystemCapability.FileManagement.StorageService.SpatialStatistics
 
-- Parameters
+
+This is a system API and cannot be called by third-party applications.
+
+
+**Parameters**
 
   | Name    | Type  | Mandatory| Description|
   | ---------- | ------ | ---- | ---- |
   | volumeUuid | string | Yes  | UUID of the volume.|
 
-- Return value
+**Return value**
 
   | Type                 | Description            |
   | --------------------- | ---------------- |
-  | Promise<number> | Promise used to return the total space of the volume.|
+  | Promise<number> | Promise used to return the total size of the volume.|
 
-- Example
+**Example**
 
   ```js
   let uuid = "";
-  storagestatistics.getTotalSizeOfVolume(uuid).then(function(number){
+  storageStatistics.getTotalSizeOfVolume(uuid).then(function(number){
       console.info("getTotalSizeOfVolume successfully:"+ number);
   }).catch(function(err){
       console.info("getTotalSizeOfVolume failed with error:"+ err);
   });
   ```
 
-## storagestatistics.getTotalSizeOfVolume
+## storageStatistics.getTotalSizeOfVolume
 
 getTotalSizeOfVolume(volumeUuid: string, callback:AsyncCallback<number>):void
 
-Asynchronously obtains the total space of the specified volume. This API uses a callback to return the result.
+Asynchronously obtains the total size of the specified volume. This API uses a callback to return the result.
+
+**Required permissions**: ohos.permission.STORAGE_MANAGER
 
 **System capability**: SystemCapability.FileManagement.StorageService.SpatialStatistics
 
-- Parameters
+
+This is a system API and cannot be called by third-party applications.
+
+
+**Parameters**
 
   | Name    | Type                                | Mandatory| Description                      |
   | ---------- | ------------------------------------ | ---- | -------------------------- |
   | volumeUuid | string                               | Yes  | UUID of the volume.                      |
-  | callback   | callback:AsyncCallback<number> | Yes  | Callback invoked to return the total space of the volume.|
+  | callback   | callback:AsyncCallback<number> | Yes  | Callback invoked to return the total size of the volume.|
 
-- Example
+**Example**
 
   ```js
   let uuid = "";
-  storagestatistics.getTotalSizeOfVolume(uuid, function(error, number){
+  storageStatistics.getTotalSizeOfVolume(uuid, function(error, number){
       // Do something.
       console.info("getTotalSizeOfVolume successfully:"+ number);
   });
   ```
-  
-  
 
-## storagestatistics.getFreeSizeOfVolume
+## storageStatistics.getFreeSizeOfVolume
 
 getFreeSizeOfVolume(volumeUuid: string): Promise<number>
 
 Asynchronously obtains the available space of the specified volume. This API uses a promise to return the result.
 
+**Required permissions**: ohos.permission.STORAGE_MANAGER
+
 **System capability**: SystemCapability.FileManagement.StorageService.SpatialStatistics
 
-- Parameters
+
+This is a system API and cannot be called by third-party applications.
+
+
+**Parameters**
 
   | Name    | Type  | Mandatory| Description|
   | ---------- | ------ | ---- | ---- |
   | volumeUuid | string | Yes  | UUID of the volume.|
 
-- Return value
+**Return value**
 
   | Type                 | Description              |
   | --------------------- | ------------------ |
   | Promise<number> | Promise used to return the available space of the volume.|
 
-- Example
+**Example**
 
   ```js
   let uuid = "";
-  storagestatistics.getFreeSizeOfVolume(uuid).then(function(number){
+  storageStatistics.getFreeSizeOfVolume(uuid).then(function(number){
       console.info("getFreeSizeOfVolume successfully:"+ number);
   }).catch(function(err){
       console.info("getFreeSizeOfVolume failed with error:"+ err);
@@ -104,95 +119,423 @@ Asynchronously obtains the available space of the specified volume. This API use
   
   ```
 
-## storagestatistics.getFreeSizeOfVolume
+## storageStatistics.getFreeSizeOfVolume
 
 getFreeSizeOfVolume(volumeUuid: string, callback:AsyncCallback<number>):void
 
 Asynchronously obtains the available space of the specified volume. This API uses a callback to return the result.
 
+**Required permissions**: ohos.permission.STORAGE_MANAGER
+
 **System capability**: SystemCapability.FileManagement.StorageService.SpatialStatistics
 
-- Parameters
+
+This is a system API and cannot be called by third-party applications.
+
+
+**Parameters**
 
   | Name    | Type                                | Mandatory| Description                        |
   | ---------- | ------------------------------------ | ---- | ---------------------------- |
   | volumeUuid | string                               | Yes  | UUID of the volume.                        |
   | callback   | callback:AsyncCallback<number> | Yes  | Callback invoked to return the available space of the volume.|
 
-- Example
+**Example**
 
   ```js
   let uuid = "";
-  storagestatistics.getFreeSizeOfVolume(uuid, function(error, number){
+  storageStatistics.getFreeSizeOfVolume(uuid, function(error, number){
       // Do something.
       console.info("getFreeSizeOfVolume successfully:"+ number);
   });
   ```
 
-## storagestatistics.getBundleStats<sup>9+</sup>
+## storageStatistics.getBundleStats<sup>9+</sup>
 
 getBundleStats(packageName: string): Promise&lt;BundleStats&gt;
 
-Asynchronously obtains application information. This API uses a promise to return the result.
+Asynchronously obtains space information of an application. This API uses a promise to return the result.
+
+**Required permissions**: ohos.permission.STORAGE_MANAGER
 
 **System capability**: SystemCapability.FileManagement.StorageService.SpatialStatistics
 
-- Parameters
+
+This is a system API and cannot be called by third-party applications.
+
+
+**Parameters**
 
   | Name     | Type  | Mandatory| Description    |
   | ----------- | ------ | ---- | -------- |
   | packageName | string | Yes  | Bundle name of the application.|
-  
-- Return value
+
+**Return value**
 
   | Type                                      | Description                      |
   | ------------------------------------------ | -------------------------- |
-  | Promise&lt;[Bundlestats](#bundlestats)&gt; | Promise used to return the application data obtained.|
+  | Promise&lt;[Bundlestats](#bundlestats)&gt; | Promise used to return the space information obtained.|
 
-- Example
+**Example**
 
   ```js
   let packageName = "";
-  storagestatistics.getBundleStats(packageName).then(function(BundleStats){
+  storageStatistics.getBundleStats(packageName).then(function(BundleStats){
       console.info("getBundleStats successfully:"+ JSON.stringify(BundleStats));
   }).catch(function(err){
       console.info("getBundleStats failed with error:"+ err);
   });
   ```
 
-## storagestatistics.getBundleStats<sup>9+</sup>
+## storageStatistics.getBundleStats<sup>9+</sup>
 
 getBundleStats(packageName: string,  callback: AsyncCallback&lt;BundleStats&gt;): void
 
-Asynchronously obtains application information. This API uses a callback to return the result.
+Asynchronously obtains space information of an application. This API uses a callback to return the result.
+
+**Required permissions**: ohos.permission.STORAGE_MANAGER
 
 **System capability**: SystemCapability.FileManagement.StorageService.SpatialStatistics
 
-- Parameters
+
+This is a system API and cannot be called by third-party applications.
+
+
+**Parameters**
 
   | Name  | Type                                                     | Mandatory| Description                                |
   | -------- | --------------------------------------------------------- | ---- | ------------------------------------ |
   | packageName | string | Yes  | Bundle name of the application.|
-  | callback | callback:AsyncCallback&lt;[Bundlestats](#bundlestats)&gt; | Yes  | Callback used to return the application information obtained.|
-  
-- Example
+  | callback | callback:AsyncCallback&lt;[Bundlestats](#bundlestats)&gt; | Yes  | Callback invoked to return the space information obtained.|
+
+**Example**
 
   ```js
   let packageName = "";
-  storagestatistics.getBundleStats(packageName, function(error, BundleStats){
+  storageStatistics.getBundleStats(packageName, function(error, BundleStats){
       // Do something.
       console.info("getBundleStats successfully:"+ JSON.stringify(BundleStats));
   });
   ```
 
+## storageStatistics.getCurrentBundleStats<sup>9+</sup>
+
+getCurrentBundleStats(): Promise&lt;BundleStats&gt;
+
+Asynchronously obtains space information of the current third-party application. This API uses a promise to return the result.
+
+**System capability**: SystemCapability.FileManagement.StorageService.SpatialStatistics
+
+**Return value**
+
+  | Type                                       | Description                      |
+  | ------------------------------------------ | -------------------------- |
+  | Promise&lt;[Bundlestats](#bundlestats)&gt; | Promise used to return the space information obtained.     |
+
+**Example**
+
+  ```js
+  let bundleStats = storageStatistics.getCurrentBundleStats();
+  console.info("getCurrentBundleStats successfully:"+ JSON.stringify(bundleStats));
+  ```
+
+## storageStatistics.getCurrentBundleStats<sup>9+</sup>
+
+getCurrentBundleStats(callback: AsyncCallback&lt;BundleStats&gt;): void
+
+Asynchronously obtains space information of the current third-party application. This API uses a callback to return the result.
+
+**System capability**: SystemCapability.FileManagement.StorageService.SpatialStatistics
+
+**Parameters**
+
+  | Name   | Type                                                      | Mandatory | Description                                |
+  | -------- | --------------------------------------------------------- | ---- | ------------------------------------ |
+  | callback | callback:AsyncCallback&lt;[BundleStats](#bundlestats)&gt; | Yes  | Callback invoked to return the space information obtained.       |
+
+**Example**
+
+  ```js
+  storageStatistics.getCurrentBundleStats(function(error, bundleStats){
+      // Do something.
+      console.info("getCurrentBundleStats successfully:"+ JSON.stringify(bundleStats));
+  });
+  ```
+
 ## BundleStats<sup>9+</sup>
 
 **System capability**: SystemCapability.FileManagement.StorageService.SpatialStatistics
 
-### Attribute
+
+This is a system API and cannot be called by third-party applications.
+
+
+### Attributes
+
+| Name     | Type  | Description          |
+| --------- | ------ | -------------- |
+| appSize   | number | Size of the application.   |
+| cacheSize | number | Cache size of the application.  |
+| dataSize  | number | Total data size of the application.|
+
+
+## storageStatistics.getTotalSize<sup>9+</sup>
+
+getTotalSize(): Promise&lt;number&gt;
+
+Obtains the total space of the built-in memory card. This API uses a promise to return the result.
+
+**Required permissions**: ohos.permission.STORAGE_MANAGER
+
+**System capability**: SystemCapability.FileManagement.StorageService.SpatialStatistics
+
+
+This is a system API and cannot be called by third-party applications.
+
+
+**Return value**
+
+  | Type                  | Description              |
+  | --------------------- | ------------------ |
+  | Promise&lt;number&gt; | Promise used to return the total space of the built-in memory card.  |
+
+**Example**
+
+  ```js
+  let number = storageStatistics.getTotalSize();
+  console.info("getTotalSize successfully:"+ JSON.stringify(number));
+  ```
+
+## storageStatistics.getTotalSize<sup>9+</sup>
+
+getTotalSize(callback: AsyncCallback&lt;number&gt;): void
+
+Obtains the total space of the built-in memory card. This API uses a callback to return the result.
+
+**Required permissions**: ohos.permission.STORAGE_MANAGER
+
+**System capability**: SystemCapability.FileManagement.StorageService.SpatialStatistics
+
+
+This is a system API and cannot be called by third-party applications.
+
+
+**Parameters**
+
+  | Name   | Type                                 | Mandatory | Description                    |
+  | -------- | ------------------------------------ | ---- | ------------------------ |
+  | callback | callback:AsyncCallback&lt;number&gt; | Yes  | Callback invoked to return the total space of the built-in memory card.|
+
+**Example**
+
+  ```js
+  storageStatistics.getTotalSize(function(error, number){
+      // Do something.
+      console.info("getTotalSize successfully:"+ JSON.stringify(number));
+  });
+  ```
+
+
+## storageStatistics.getFreeSize<sup>9+</sup>
+
+getFreeSize(): Promise&lt;number&gt;
+
+Obtains the available space of the built-in memory card. This API uses a promise to return the result.
+
+**Required permissions**: ohos.permission.STORAGE_MANAGER
+
+**System capability**: SystemCapability.FileManagement.StorageService.SpatialStatistics
+
+
+This is a system API and cannot be called by third-party applications.
+
+
+**Return value**
+
+  | Type                  | Description              |
+  | --------------------- | ------------------ |
+  | Promise&lt;number&gt; | Promise used to return the available space of the built-in memory card.|
+
+**Example**
+
+  ```js
+  let number = storageStatistics.getFreeSize();
+  console.info("getFreeSize successfully:"+ JSON.stringify(number));
+  ```
+
+
+## storageStatistics.getFreeSize<sup>9+</sup>
+
+getFreeSize(callback: AsyncCallback&lt;number&gt;): void
+
+Obtains the available space of the built-in memory card. This API uses a callback to return the result.
+
+**Required permissions**: ohos.permission.STORAGE_MANAGER
+
+**System capability**: SystemCapability.FileManagement.StorageService.SpatialStatistics
+
+
+This is a system API and cannot be called by third-party applications.
+
+
+**Parameters**
+
+  | Name   | Type                                 | Mandatory| Description                      |
+  | -------- | ------------------------------------ | ---- | ------------------------- |
+  | callback | callback:AsyncCallback&lt;number&gt; | Yes  | Callback invoked to return the available space of the built-in memory card.|
+
+**Example**
+
+  ```js
+  storageStatistics.getFreeSize(function(error, number){
+      // Do something.
+      console.info("getFreeSize successfully:"+ JSON.stringify(number));
+  });
+  ```
+
+## storageStatistics.getSystemSize<sup>9+</sup>
+
+getSystemSize(): Promise&lt;number&gt;
+
+Asynchronously obtains the system space. This API uses a promise to return the result.
+
+**Required permissions**: ohos.permission.STORAGE_MANAGER
+
+**System capability**: SystemCapability.FileManagement.StorageService.SpatialStatistics
+
+
+This is a system API and cannot be called by third-party applications.
+
+
+**Return value**
+
+  | Type                 | Description            |
+  | --------------------- | ---------------- |
+  | Promise&lt;number&gt; | Promise used to return the system space obtained.|
+
+**Example**
+
+  ```js
+  storageStatistics.getSystemSize().then(function(number){
+      console.info("getSystemSize successfully:"+ number);
+  }).catch(function(err){
+      console.info("getSystemSize failed with error:"+ err);
+  });
+  ```
+
+## storageStatistics.getSystemSize<sup>9+</sup>
+
+getSystemSize(callback:AsyncCallback&lt;number&gt;):void
+
+Asynchronously obtains the system space. This API uses a callback to return the result.
+
+**Required permissions**: ohos.permission.STORAGE_MANAGER
+
+**System capability**: SystemCapability.FileManagement.StorageService.SpatialStatistics
+
+
+This is a system API and cannot be called by third-party applications.
+
+
+**Parameters**
+
+  | Name    | Type                                | Mandatory| Description                      |
+  | ---------- | ------------------------------------ | ---- | -------------------------- |
+  | callback   | callback:AsyncCallback&lt;number&gt; | Yes  | Callback used to return the system space obtained.|
+
+**Example**
+
+  ```js
+  storageStatistics.getSystemSize(function(error, number){
+      // Do something.
+      console.info("getSystemSize successfully:"+ number);
+  });
+  ```
+
+## storageStatistics.getUserStorageStats<sup>9+</sup>
+
+getUserStorageStats(userId? : number): Promise&lt;StorageStats&gt;
+
+Asynchronously obtains the space occupied by each type of user data. This API uses a promise to return the result.
+
+**Required permissions**: ohos.permission.STORAGE_MANAGER
+
+**System capability**: SystemCapability.FileManagement.StorageService.SpatialStatistics
+
+
+This is a system API and cannot be called by third-party applications.
+
+
+**Parameters**
+
+  | Name    | Type  | Mandatory| Description|
+  | ---------- | ------ | ---- | ---- |
+  | userId | string | No  | User ID.<br>Value:<br>-&nbsp; Set this parameter to the ID of the user to be queried.<br>-&nbsp; If no value is specified, information about the current user is queried.|
+
+**Return value**
+
+  | Type                 | Description            |
+  | --------------------- | ---------------- |
+  | Promise&lt;[StorageStats](#StorageStats)&gt; | Promise used to return the information obtained.|
+
+**Example**
+
+  ```js
+  let userId = "";
+  storageStatistics.getUserStorageStats(userId).then(function(StorageStats){
+      console.info("getUserStorageStats successfully:"+ JSON.stringify(StorageStats));
+  }).catch(function(err){
+      console.info("getUserStorageStats failed with error:"+ err);
+  });
+  ```
+
+## storageStatistics.getUserStorageStats<sup>9+</sup>
+
+getUserStorageStats(userId: number, callback:AsyncCallback&lt;StorageStats&gt;):void
+
+Asynchronously obtains the space occupied by each type of user data. This API uses a callback to return the result.
+
+**Required permissions**: ohos.permission.STORAGE_MANAGER
+
+**System capability**: SystemCapability.FileManagement.StorageService.SpatialStatistics
+
+
+This is a system API and cannot be called by third-party applications.
+
+
+**Parameters**
+
+  | Name    | Type                                | Mandatory| Description                      |
+  | ---------- | ------------------------------------ | ---- | -------------------------- |
+  | userId | string                               | No  | User ID.<br>Value:<br>-&nbsp; Set this parameter to the ID of the user to be queried.<br>-&nbsp; If no value is specified, information about the current user is queried.                      |
+  | callback   | callback:AsyncCallback&lt;[StorageStats](#StorageStats)&gt; | Yes  | Callback invoked to return the information obtained.|
+
+**Example**
+
+  ```js
+  let userId = "";
+  storageStatistics.getUserStorageStats(userId, function(error, StorageStats){
+      // Do something.
+      console.info("getUserStorageStats successfully:"+ JSON.stringify(StorageStats));
+  });
+  ```
+
+
+## StorageStats<sup>9+</sup>
+
+**System capability**: SystemCapability.FileManagement.StorageService.SpatialStatistics
+
+
+This is a system API and cannot be called by third-party applications.
+
+
+### Attributes
 
 | Name     | Type  | Description          |
 | --------- | ------ | -------------- |
-| appSize<sup>9+</sup>   | number | Size of the application.   |
-| cacheSize<sup>9+</sup> | number | Cache size of the application.  |
-| dataSize<sup>9+</sup>  | number | Total data size of the application.|
+| total   | number | Total space of the built-in memory card.   |
+| audio | number | Space occupied by audio data.  |
+| video  | number | Space occupied by video data.|
+| image   | number | Space occupied by image data.   |
+| file | number | Space occupied by files.  |
+| app  | number | Space occupied by application data.|