From b6f53667952ed0d233c6e2b17343e3d30357f028 Mon Sep 17 00:00:00 2001
From: annie_wangli <annie.wangli@huawei.com>
Date: Fri, 11 Feb 2022 14:10:09 +0800
Subject: [PATCH] update docs

Signed-off-by: annie_wangli <annie.wangli@huawei.com>
---
 .../reference/apis/js-apis-statfs.md          | 115 ++++++++++++++++++
 1 file changed, 115 insertions(+)
 create mode 100644 en/application-dev/reference/apis/js-apis-statfs.md

diff --git a/en/application-dev/reference/apis/js-apis-statfs.md b/en/application-dev/reference/apis/js-apis-statfs.md
new file mode 100644
index 0000000000..c35b68d23a
--- /dev/null
+++ b/en/application-dev/reference/apis/js-apis-statfs.md
@@ -0,0 +1,115 @@
+# 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&lt;number&gt;
+
+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&lt;number&gt; | Number of free bytes obtained.|
+
+- Example
+
+  ```
+  let num = await statfs.getFreeBytes(path);
+  ```
+
+## statfs.getFreeBytes
+
+getFreeBytes(path:string, callback:AsyncCallback&lt;number&gt;): 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&lt;number&gt; | 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&lt;number&gt;
+
+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&lt;number&gt; | Total number of bytes obtained.|
+
+- Example
+
+  ```
+  let num = await statfs.getTotalBytes(path);
+  ```
+
+## statfs.getTotalBytes
+
+getTotalBytes(path:string, callback:AsyncCallback&lt;number&gt;): 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&lt;number&gt; | Yes| Callback invoked to return the total number of bytes obtained.|
+
+- Example
+
+  ```
+  statfs.getTotalBytes(path, function(err, number){
+      //do something
+  });
+  ```
-- 
GitLab