!1456 #I4OTIU已完成，请审核

Merge pull request !1456 from Annie_wang/PR1053

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

+# statfs
+
+
+
+## Modules to Import
+
+```
+import statfs from '@ohos.statfs'
+```
+
+## Note
+
+Before using this module to perform operations on a file or directory, obtain the absolute path of the file or directory. For details, see [getOrCreateLocalDir of the Context module](js-apis-Context.md).
+
+Absolute file or directory path = Application directory + File name or directory name
+
+For example, if the application directory obtained by using **getOrCreateLocalDir** is **dir** and the file name is **xxx.txt**, the absolute path of the file is as follows:
+
+```
+let path = dir + "xxx.txt"
+```
+
+## Required Permissions
+
+None
+
+## statfs.getFreeBytes
+
+getFreeBytes(path:string):Promise<number>
+
+Obtains the number of free bytes of the specified file system in asynchronous mode. This method uses a promise to return the result.
+
+- Parameters
+
+  | Name| Type| Mandatory| Description|
+  | ------ | ------ | ---- | ---------------------------- |
+  | path   | string | Yes| File path of the file system.|
+
+- Return values
+
+  | Type| Description|
+  | --------------------- | -------------- |
+  | Promise<number> | Number of free bytes obtained.|
+
+- Example
+
+  ```
+  let num = await statfs.getFreeBytes(path);
+  ```
+
+## statfs.getFreeBytes
+
+getFreeBytes(path:string, callback:AsyncCallback<number>): void
+
+Obtains the number of free bytes of the specified file system in asynchronous mode. This method uses a callback to return the result.
+
+- Parameters
+
+  | Name| Type| Mandatory| Description|
+  | -------- | --------------------------- | ---- | ---------------------------- |
+  | path     | string                      | Yes| File path of the file system.|
+  | callback | AsyncCallback<number> | Yes| Callback invoked to return the number of free bytes obtained.|
+
+- Example
+
+  ```
+  statfs.getFreeBytes(path, function(err, number){
+      // Do something.
+  });
+  ```
+
+## statfs.getTotalBytes
+
+getTotalBytes.(path:string):Promise<number>
+
+Obtains the total number of bytes of the specified file system in asynchronous mode. This method uses a promise to return the result.
+
+- Parameters
+
+  | Name| Type| Mandatory| Description|
+  | ---- | ------ | ---- | ---------------------------- |
+  | path | string | Yes| File path of the file system.|
+
+- Return values
+
+  | Type| Description|
+  | --------------------- | ------------ |
+  | Promise<number> | Total number of bytes obtained.|
+
+- Example
+
+  ```
+  let num = await statfs.getTotalBytes(path);
+  ```
+
+## statfs.getTotalBytes
+
+getTotalBytes(path:string, callback:AsyncCallback<number>): void
+
+Obtains the total number of bytes of the specified file system in asynchronous mode. This method uses a callback to return the result.
+
+- Parameters
+
+  | Name| Type| Mandatory| Description|
+  | -------- | --------------------------- | ---- | ---------------------------- |
+  | path     | string                      | Yes| File path of the file system.|
+  | callback | AsyncCallback<number> | Yes| Callback invoked to return the total number of bytes obtained.|
+
+- Example
+
+  ```
+  statfs.getTotalBytes(path, function(err, number){
+      // Do something.
+  });
+  ```