!5348 [翻译完成】#I59L2L

Merge pull request !5348 from Annie_wang/PR4551

!5348 [翻译完成】#I59L2L
Merge pull request !5348 from Annie_wang/PR4551
c7c7928f · openharmony_ci · Gitee · 27022dab · 114fc394 · c7c7928f
3 changed file
--- a/en/application-dev/reference/apis/js-apis-data-preferences.md
+++ b/en/application-dev/reference/apis/js-apis-data-preferences.md
 # Preferences

-Preferences provide capabilities for processing data in the form of key-value (KV) pairs and supports lightweight data persistence, modification, and query. In KV pairs, keys are of the string type, and values can be of the number, string, or Boolean type.
+Preferences provide capabilities for processing data in the form of key-value (KV) pairs and support lightweight data persistence, modification, and query. In KV pairs, keys are of the string type, and values can be of the number, string, or Boolean type.


 > **NOTE**<br/>
@@ -19,8 +19,8 @@ import data_preferences from '@ohos.data.preferences';

 | Name| Type| Readable| Writable| Description|
 | -------- | -------- | -------- | -------- | -------- |
-| MAX_KEY_LENGTH | string | Yes| No| Maximum length of a key. It is 80 bytes.|
-| MAX_VALUE_LENGTH | string | Yes| No| Maximum length of a value. It is 8192 bytes.|
+| MAX_KEY_LENGTH | string | Yes| No| Maximum length of a key. It must be less than 80 bytes.|
+| MAX_VALUE_LENGTH | string | Yes| No| Maximum length of a value. It must be less than 8192 bytes.|


 ## data_preferences.getPreferences
@@ -33,11 +33,11 @@ Reads a **Preferences** persistence file and loads data to the **Preferences** i
 **System capability**: SystemCapability.DistributedDataManager.Preferences.Core

 **Parameters**
-  | Name| Type| Mandatory| Description|
-  | -------- | -------- | -------- | -------- |
-  | context | [Context](js-apis-ability-context.md) | Yes| Context of the application or functionality.|
-  | name | string | Yes| Name of the **Preferences** instance persistence file.|
-  | callback | AsyncCallback&lt;[Preferences](#preferences)&gt; | Yes| Callback used to return the result.|
+| Name| Type| Mandatory| Description|
+| -------- | -------- | -------- | -------- |
+| context | [Context](js-apis-ability-context.md) | Yes| Context of the application or functionality.|
+| name | string | Yes| Name of the **Preferences** instance persistence file.|
+| callback | AsyncCallback&lt;[Preferences](#preferences)&gt; | Yes| Callback used to return the result.|

 **Example**
 ```ts
@@ -60,15 +60,15 @@ Reads a **Preferences** persistence file and loads data to the **Preferences** i
 **System capability**: SystemCapability.DistributedDataManager.Preferences.Core

 **Parameters**
-  | Name| Type| Mandatory| Description|
-  | -------- | -------- | -------- | -------- |
-  | context | [Context](js-apis-ability-context.md) | Yes| Context of the application or functionality.|
-  | name | string | Yes| Name of the **Preferences** instance persistence file.|
+| Name| Type| Mandatory| Description|
+| -------- | -------- | -------- | -------- |
+| context | [Context](js-apis-ability-context.md) | Yes| Context of the application or functionality.|
+| name | string | Yes| Name of the **Preferences** instance persistence file.|

 **Return value**
-  | Type| Description|
-  | -------- | -------- |
-  | Promise&lt;[Preferences](#preferences)&gt; | Promise used to return the result.|
+| Type| Description|
+| -------- | -------- |
+| Promise&lt;[Preferences](#preferences)&gt; | Promise used to return the result.|

 **Example**
 ```ts
@@ -91,11 +91,11 @@ Once a **Preferences** persistence file is deleted, the **Preferences** instance
 **System capability**: SystemCapability.DistributedDataManager.Preferences.Core

 **Parameters**
-  | Name| Type| Mandatory| Description|
-  | -------- | -------- | -------- | -------- |
-  | context | [Context](js-apis-ability-context.md) | Yes| Context of the application or functionality.|
-  | name | string | Yes| Name of the **Preferences** instance persistence file.|
-  | callback | AsyncCallback&lt;void&gt; | Yes| Callback used to return the result.|
+| Name| Type| Mandatory| Description|
+| -------- | -------- | -------- | -------- |
+| context | [Context](js-apis-ability-context.md) | Yes| Context of the application or functionality.|
+| name | string | Yes| Name of the **Preferences** instance persistence file.|
+| callback | AsyncCallback&lt;void&gt; | Yes| Callback used to return the result.|

 **Example**
 ```ts
@@ -119,15 +119,15 @@ Once a **Preferences** persistence file is deleted, the **Preferences** instance
 **System capability**: SystemCapability.DistributedDataManager.Preferences.Core

 **Parameters**
-  | Name| Type| Mandatory| Description|
-  | -------- | -------- | -------- | -------- |
-  | context | [Context](js-apis-ability-context.md) | Yes| Context of the application or functionality.|
-  | name | string | Yes| Name of the **Preferences** instance persistence file.|
+| Name| Type| Mandatory| Description|
+| -------- | -------- | -------- | -------- |
+| context | [Context](js-apis-ability-context.md) | Yes| Context of the application or functionality.|
+| name | string | Yes| Name of the **Preferences** instance persistence file.|

 **Return value**
-  | Type| Description|
-  | -------- | -------- |
-  | Promise&lt;void&gt; | Promise used to return the result.|
+| Type| Description|
+| -------- | -------- |
+| Promise&lt;void&gt; | Promise used to return the result.|

 **Example**
 ```ts
@@ -151,11 +151,11 @@ When a **Preferences** singleton instance is removed, this instance cannot be us
 **System capability**: SystemCapability.DistributedDataManager.Preferences.Core

 **Parameters**
-  | Name| Type| Mandatory| Description|
-  | -------- | -------- | -------- | -------- |
-  | context | [Context](js-apis-ability-context.md) | Yes| Context of the application or functionality.|
-  | name | string | Yes| Name of the **Preferences** instance persistence file.|
-  | callback | AsyncCallback&lt;void&gt; | Yes| Callback used to return the result.|
+| Name| Type| Mandatory| Description|
+| -------- | -------- | -------- | -------- |
+| context | [Context](js-apis-ability-context.md) | Yes| Context of the application or functionality.|
+| name | string | Yes| Name of the **Preferences** instance persistence file.|
+| callback | AsyncCallback&lt;void&gt; | Yes| Callback used to return the result.|

 **Example**
 ```ts
@@ -179,16 +179,16 @@ When a **Preferences** singleton instance is removed, this instance cannot be us

 **System capability**: SystemCapability.DistributedDataManager.Preferences.Core

-Parameters
-  | Name| Type| Mandatory| Description|
-  | -------- | -------- | -------- | -------- |
-  | context | [Context](js-apis-ability-context.md) | Yes| Context of the application or functionality.|
-  | name | string | Yes| Name of the **Preferences** instance persistence file.|
+**Parameters**
+| Name| Type| Mandatory| Description|
+| -------- | -------- | -------- | -------- |
+| context | [Context](js-apis-ability-context.md) | Yes| Context of the application or functionality.|
+| name | string | Yes| Name of the **Preferences** instance persistence file.|

 **Return value**
-  | Type| Description|
-  | -------- | -------- |
-  | Promise&lt;void&gt; | Promise used to return the result.|
+| Type| Description|
+| -------- | -------- |
+| Promise&lt;void&gt; | Promise used to return the result.|

 **Example**
 ```ts
@@ -215,15 +215,15 @@ Obtains the value of a key. If the value is null or a non-default value, the def
 **System capability**: SystemCapability.DistributedDataManager.Preferences.Core

 **Parameters**
-  | Name| Type| Mandatory| Description|
-  | -------- | -------- | -------- | -------- |
-  | key | string | Yes| Key of the data to obtain. It cannot be empty.|
-  | defValue | [ValueType](#valuetype) | Yes| Default value to be returned. It can be a number, string, or Boolean value.|
-  | callback | AsyncCallback&lt;ValueType&gt; | Yes| Callback used to return the result.|
+| Name| Type| Mandatory| Description|
+| -------- | -------- | -------- | -------- |
+| key | string | Yes| Key of the data to obtain. It cannot be empty.|
+| defValue | [ValueType](#valuetype) | Yes| Default value to be returned. It can be a number, string, or Boolean value.|
+| callback | AsyncCallback&lt;ValueType&gt; | Yes| Callback used to return the result.|

 **Example**
 ```ts
- preferences.get('startup', 'default', function(err, value) {
+preferences.get('startup', 'default', function(err, value) {
    if (err) {
                  console.info("Failed to get the value of startup, err: " + err)
        return
@@ -242,15 +242,15 @@ Obtains the value of a key. If the value is null or a non-default value, the def
 **System capability**: SystemCapability.DistributedDataManager.Preferences.Core

 **Parameters**
-  | Name| Type| Mandatory| Description|
-  | -------- | -------- | -------- | -------- |
-  | key | string | Yes| Key of the data to obtain. It cannot be empty.|
-  | defValue | [ValueType](#valuetype) | Yes| Default value to be returned. It can be a number, string, or Boolean value.|
+| Name| Type| Mandatory| Description|
+| -------- | -------- | -------- | -------- |
+| key | string | Yes| Key of the data to obtain. It cannot be empty.|
+| defValue | [ValueType](#valuetype) | Yes| Default value to be returned. It can be a number, string, or Boolean value.|

 **Return value**
-  | Type| Description|
-  | -------- | -------- |
-  | Promise&lt;ValueType&gt; | Promise used to return the result.|
+| Type| Description|
+| -------- | -------- |
+| Promise&lt;ValueType&gt; | Promise used to return the result.|

 **Example**
 ```ts
@@ -262,6 +262,57 @@ promise.then((value) => {
 })
 ```

+### getAll
+
+getAll(callback: AsyncCallback&lt;Object&gt;): void;
+
+Obtains the **Object** instance that contains all KV pairs.
+
+**System capability**: SystemCapability.DistributedDataManager.Preferences.Core
+
+**Parameters**
+| Name| Type| Mandatory| Description|
+| -------- | -------- | -------- | -------- |
+| callback | AsyncCallback&lt;Object&gt; | Yes| Callback used to return the **Object** instance obtained.|
+
+**Example**
+```ts
+preferences.get.getAll(function (err, value) {
+    if (err) {
+        console.info("getAll failed, err: " + err)
+        return
+    }
+    let keys = Object.keys(value)
+    console.info('getAll keys = ' + keys)
+    console.info("getAll object = " + JSON.stringify(value))
+});
+```
+
+
+### getAll
+
+getAll(): Promise&lt;Object&gt;
+
+Obtains the **Object** instance that contains all KV pairs.
+
+**System capability**: SystemCapability.DistributedDataManager.Preferences.Core
+
+**Return value**
+| Type| Description|
+| -------- | -------- |
+| Promise&lt;Object&gt; | Promise used to return the **Object** instance obtained.|
+
+**Example**
+```ts
+let promise = preferences.getAll()
+promise.then((value) => {
+    let keys = Object.keys(value)
+    console.info('getAll keys = ' + keys)
+    console.info("getAll object = " + JSON.stringify(value))
+}).catch((err) => {
+    console.info("getAll failed, err: " + err)
+})
+```

 ### put

@@ -272,11 +323,11 @@ Puts a new value to this **Preferences** instance and its persistence file. This
 **System capability**: SystemCapability.DistributedDataManager.Preferences.Core

 **Parameters**
-  | Name| Type| Mandatory| Description|
-  | -------- | -------- | -------- | -------- |
-  | key | string | Yes| Key of the data. It cannot be empty.|
-  | value | [ValueType](#valuetype) | Yes| New value to store. It can be a number, string, or Boolean value.|
-  | callback | AsyncCallback&lt;void&gt; | Yes| Callback used to return the result.|
+| Name| Type| Mandatory| Description|
+| -------- | -------- | -------- | -------- |
+| key | string | Yes| Key of the data. It cannot be empty.|
+| value | [ValueType](#valuetype) | Yes| New value to store. It can be a number, string, or Boolean value.|
+| callback | AsyncCallback&lt;void&gt; | Yes| Callback used to return the result.|

 **Example**
 ```ts
@@ -299,15 +350,15 @@ Puts a new value to this **Preferences** instance and its persistence file. This
 **System capability**: SystemCapability.DistributedDataManager.Preferences.Core

 **Parameters**
-  | Name| Type| Mandatory| Description|
-  | -------- | -------- | -------- | -------- |
-  | key | string | Yes| Key of the data. It cannot be empty.|
-  | value | [ValueType](#valuetype) | Yes| New value to store. It can be a number, string, or Boolean value.|
+| Name| Type| Mandatory| Description|
+| -------- | -------- | -------- | -------- |
+| key | string | Yes| Key of the data. It cannot be empty.|
+| value | [ValueType](#valuetype) | Yes| New value to store. It can be a number, string, or Boolean value.|

 **Return value**
-  | Type| Description|
-  | -------- | -------- |
-  | Promise&lt;void&gt; | Promise used to return the result.|
+| Type| Description|
+| -------- | -------- |
+| Promise&lt;void&gt; | Promise used to return the result.|

 **Example**
 ```ts
@@ -322,22 +373,17 @@ promise.then(() => {

 ### has

-has(key: string, callback: AsyncCallback&lt;boolean&gt;): boolean
+has(key: string, callback: AsyncCallback&lt;boolean&gt;): void

 Checks whether this **Preferences** instance contains data with a given key. This API uses an asynchronous callback to return the result.

 **System capability**: SystemCapability.DistributedDataManager.Preferences.Core

 **Parameters**
-  | Name| Type| Mandatory| Description|
-  | -------- | -------- | -------- | -------- |
-  | key | string | Yes| Key of the data to check. It cannot be empty.|
-  | callback | AsyncCallback&lt;boolean&gt; | Yes| Callback used to return the result.|
-
-**Return value**
-  | Type| Description|
-  | -------- | -------- |
-  | boolean | Returns **true** if the **Preferences** instance contains data with the specified key; returns **false** otherwise.|
+| Name| Type| Mandatory| Description|
+| -------- | -------- | -------- | -------- |
+| key | string | Yes| Key of the data to check. It cannot be empty.|
+| callback | AsyncCallback&lt;boolean&gt; | Yes| Callback used to return the result. It returns **true** if the **Preferences** instance contains data with the given key and returns **false** otherwise.|

 **Example**
 ```ts
@@ -364,14 +410,14 @@ Checks whether this **Preferences** instance contains data with a given key. Thi
 **System capability**: SystemCapability.DistributedDataManager.Preferences.Core

 **Parameters**
-  | Name| Type| Mandatory| Description|
-  | -------- | -------- | -------- | -------- |
-  | key | string | Yes| Key of the data to check. It cannot be empty.|
+| Name| Type| Mandatory| Description|
+| -------- | -------- | -------- | -------- |
+| key | string | Yes| Key of the data to check. It cannot be empty.|

 **Return value**
-  | Type| Description|
-  | -------- | -------- |
-  | Promise&lt;boolean&gt; | Promise used to return the result.|
+| Type| Description|
+| -------- | -------- |
+| Promise&lt;boolean&gt; | Promise used to return the result. It returns **true** if the **Preferences** instance contains data with the given key and returns **false** otherwise.|

 **Example**
 ```ts
@@ -383,7 +429,7 @@ promise.then((isExist) => {
        console.info("The key of startup is not contained.")
    }
 }).catch((err) => {
-              console.info("Check the key of startup failed, err: " + err)
+    console.info("Failed to check the key of startup, err: " + err)
 })
 ```

@@ -397,10 +443,10 @@ Deletes a KV pair of the specified key from this **Preferences** instance. This
 **System capability**: SystemCapability.DistributedDataManager.Preferences.Core

 **Parameters**
-  | Name| Type| Mandatory| Description|
-  | -------- | -------- | -------- | -------- |
-  | key | string | Yes| Key of the KV pair to delete. It cannot be empty.|
-  | callback | AsyncCallback&lt;void&gt; | Yes| Callback used to return the result.|
+| Name| Type| Mandatory| Description|
+| -------- | -------- | -------- | -------- |
+| key | string | Yes| Key of the KV pair to delete. It cannot be empty.|
+| callback | AsyncCallback&lt;void&gt; | Yes| Callback used to return the result.|

 **Example**
 ```ts
@@ -423,14 +469,14 @@ Deletes a KV pair of the specified key from this **Preferences** instance. This
 **System capability**: SystemCapability.DistributedDataManager.Preferences.Core

 **Parameters**
-  | Name| Type| Mandatory| Description|
-  | -------- | -------- | -------- | -------- |
-  | key | string | Yes| Key of the KV pair to delete. It cannot be empty.|
+| Name| Type| Mandatory| Description|
+| -------- | -------- | -------- | -------- |
+| key | string | Yes| Key of the KV pair to delete. It cannot be empty.|

 **Return value**
-  | Type| Description|
-  | -------- | -------- |
-  | Promise&lt;void&gt; | Promise used to return the result.|
+| Type| Description|
+| -------- | -------- |
+| Promise&lt;void&gt; | Promise used to return the result.|

 **Example**
 ```ts
@@ -452,9 +498,9 @@ Saves the modification to this **Preferences** instance and synchronizes the mod
 **System capability**: SystemCapability.DistributedDataManager.Preferences.Core

 **Parameters**
-  | Name| Type| Mandatory| Description|
-  | -------- | -------- | -------- | -------- |
-  | callback | AsyncCallback&lt;void&gt; | Yes| Callback used to return the result.|
+| Name| Type| Mandatory| Description|
+| -------- | -------- | -------- | -------- |
+| callback | AsyncCallback&lt;void&gt; | Yes| Callback used to return the result.|

 **Example**
 ```ts
@@ -477,9 +523,9 @@ Saves the modification to this **Preferences** instance and synchronizes the mod
 **System capability**: SystemCapability.DistributedDataManager.Preferences.Core

 **Return value**
-  | Type| Description|
-  | -------- | -------- |
-  | Promise&lt;void&gt; | Promise used to return the result.|
+| Type| Description|
+| -------- | -------- |
+| Promise&lt;void&gt; | Promise used to return the result.|

 **Example**
 ```ts
@@ -500,10 +546,10 @@ Clears data of this **Preferences** instance. This API uses an asynchronous call

 **System capability**: SystemCapability.DistributedDataManager.Preferences.Core

-Parameters
-  | Name| Type| Mandatory| Description|
-  | -------- | -------- | -------- | -------- |
-  | callback | AsyncCallback&lt;void&gt; | Yes| Callback used to return the result.|
+**Parameters**
+| Name| Type| Mandatory| Description|
+| -------- | -------- | -------- | -------- |
+| callback | AsyncCallback&lt;void&gt; | Yes| Callback used to return the result.|

 **Example**
 ```ts
@@ -526,9 +572,9 @@ Clears data of this **Preferences** instance. This API uses a promise to return
 **System capability**: SystemCapability.DistributedDataManager.Preferences.Core

 **Return value**
-  | Type| Description|
-  | -------- | -------- |
-  | Promise&lt;void&gt; | Promise used to return the result.|
+| Type| Description|
+| -------- | -------- |
+| Promise&lt;void&gt; | Promise used to return the result.|

 **Example**
 ```ts
@@ -550,10 +596,10 @@ Subscribes to data changes. When the value of the subscribed key changes, a call
 **System capability**: SystemCapability.DistributedDataManager.Preferences.Core

 **Parameters**
-  | Name| Type| Description|
-  | -------- | -------- | -------- |
-  | type | string | Event type. The value **change** indicates data change events.|
-  | callback | Callback&lt;{ key : string }&gt; | Callback used to return data changes.|
+| Name| Type| Mandatory| Description|
+| -------- | -------- | -------- | -------- |
+| type | string | Yes|  Event type. The value **change** indicates data change events.|
+| callback | Callback&lt;{ key : string }&gt;  | Yes| Callback used to return data changes.|

 **Example**
 ```ts
@@ -584,17 +630,17 @@ preferences.put('startup', 'auto', function (err) {

 ### off('change')

-off(type: 'change', callback: Callback&lt;{ key : string }&gt;): void
+off(type: 'change', callback?: Callback&lt;{ key : string }&gt;): void

 Unsubscribes from data changes.

 **System capability**: SystemCapability.DistributedDataManager.Preferences.Core

 **Parameters**
-  | Name| Type| Description|
-  | -------- | -------- | -------- |
-  | type | string | Event type. The value **change** indicates data change events.|
-  | callback | Callback&lt;{ key : string }&gt; | Callback used to return data changes.|
+| Name| Type| Mandatory| Description|
+| -------- | -------- | -------- | -------- |
+| type | string | Yes| Event type. The value **change** indicates data change events.|
+| callback | Callback&lt;{ key : string }&gt;  | No| Callback used to return data changes. If this parameter is left empty, all callbacks for data changes will be canceled.|

 **Example**
 ```ts

--- a/en/application-dev/reference/apis/js-apis-data-storage.md
+++ b/en/application-dev/reference/apis/js-apis-data-storage.md
@@ -22,15 +22,15 @@ import dataStorage from '@ohos.data.storage';

 | Name| Type| Readable| Writable| Description|
 | -------- | -------- | -------- | -------- | -------- |
-| MAX_KEY_LENGTH | string | Yes| No| Maximum length of a key. It is 80 bytes.|
-| MAX_VALUE_LENGTH | string | Yes| No| Maximum length of a value. It is 8192 bytes.|
+| MAX_KEY_LENGTH | string | Yes| No| Maximum length of a key. It must be less than 80 bytes.|
+| MAX_VALUE_LENGTH | string | Yes| No| Maximum length of a value. It must be less than 8192 bytes.|


 ## dataStorage.getStorageSync

 getStorageSync(path: string): Storage

-Reads the specified file and load its data to the **Storage** instance for data operations.
+Reads the specified file and loads its data to the **Storage** instance for data operations.

 **System capability**: SystemCapability.DistributedDataManager.Preferences.Core


--- a/en/application-dev/reference/apis/js-apis-system-storage.md
+++ b/en/application-dev/reference/apis/js-apis-system-storage.md
@@ -68,7 +68,7 @@ Sets the value in the cache based on the specified key.
 | Name| Type| Mandatory| Description|
 | -------- | -------- | -------- | -------- |
 | key | string | Yes| Key of the data to set.|
-| value | string | Yes| New value to set. The maximum length is 128 bytes.|
+| value | string | Yes| New value to set. The length must be less than 128 bytes.|
 | success | Function | No| Called when **storage.set()** is successful.|
 | fail | Function | No| Called when **storage.set()** fails. In the callback, **data** indicates the error information, and **code** indicates the error code.|
 | complete | Function | No| Called when **storage.set()** is complete.|