1# 分布式数据库操作描述<a name="ZH-CN_TOPIC_0000001209210727"></a> 2 3> **说明：** 4>从 API Version 7 开始支持。 5 6## 导入模块<a name="zh-cn_topic_0000001175986853_s56d19203690d4782bfc74069abb6bd71"></a> 7 8``` 9import factory from '@ohos.data.distributeddata'; 10``` 11 12## 权限<a name="zh-cn_topic_0000001175986853_section11257113618419"></a> 13 14无 15 16## KVStore<a name="zh-cn_topic_0000001175986853_section12882825611"></a> 17 18表示分布式数据库，并提供添加数据、删除数据和订阅数据变更的方法。 19 20### put\(key: string, value: Uint8Array | string | number | boolean, callback: AsyncCallback<void\>\): void<a name="zh-cn_topic_0000001175986853_section1942221513"></a> 21 22添加指定类型键值对到数据库。 23 24此方法是异步callback方法。 25 26- 参数： 27 28 <a name="zh-cn_topic_0000001175986853_table139428218117"></a> 29 <table><thead align="left"><tr id="zh-cn_topic_0000001175986853_row8943821510"><th class="cellrowborder" valign="top" width="16.54%" id="mcps1.1.4.1.1"><p id="zh-cn_topic_0000001175986853_p139439212111"><a name="zh-cn_topic_0000001175986853_p139439212111"></a><a name="zh-cn_topic_0000001175986853_p139439212111"></a>参数名</p> 30 </th> 31 <th class="cellrowborder" valign="top" width="24.68%" id="mcps1.1.4.1.2"><p id="zh-cn_topic_0000001175986853_p5943721919"><a name="zh-cn_topic_0000001175986853_p5943721919"></a><a name="zh-cn_topic_0000001175986853_p5943721919"></a>类型</p> 32 </th> 33 <th class="cellrowborder" valign="top" width="58.78%" id="mcps1.1.4.1.3"><p id="zh-cn_topic_0000001175986853_p11943142518"><a name="zh-cn_topic_0000001175986853_p11943142518"></a><a name="zh-cn_topic_0000001175986853_p11943142518"></a>说明</p> 34 </th> 35 </tr> 36 </thead> 37 <tbody><tr id="zh-cn_topic_0000001175986853_row1794311214119"><td class="cellrowborder" valign="top" width="16.54%" headers="mcps1.1.4.1.1 "><p id="zh-cn_topic_0000001175986853_p1094402916"><a name="zh-cn_topic_0000001175986853_p1094402916"></a><a name="zh-cn_topic_0000001175986853_p1094402916"></a>key</p> 38 </td> 39 <td class="cellrowborder" valign="top" width="24.68%" headers="mcps1.1.4.1.2 "><p id="zh-cn_topic_0000001175986853_p794412718"><a name="zh-cn_topic_0000001175986853_p794412718"></a><a name="zh-cn_topic_0000001175986853_p794412718"></a>string</p> 40 </td> 41 <td class="cellrowborder" valign="top" width="58.78%" headers="mcps1.1.4.1.3 "><p id="zh-cn_topic_0000001175986853_p2944424110"><a name="zh-cn_topic_0000001175986853_p2944424110"></a><a name="zh-cn_topic_0000001175986853_p2944424110"></a>要添加数据的key。不能为空且长度不大于1KB。</p> 42 </td> 43 </tr> 44 <tr id="zh-cn_topic_0000001175986853_row5944129113"><td class="cellrowborder" valign="top" width="16.54%" headers="mcps1.1.4.1.1 "><p id="zh-cn_topic_0000001175986853_p8944929118"><a name="zh-cn_topic_0000001175986853_p8944929118"></a><a name="zh-cn_topic_0000001175986853_p8944929118"></a>value</p> 45 </td> 46 <td class="cellrowborder" valign="top" width="24.68%" headers="mcps1.1.4.1.2 "><p id="zh-cn_topic_0000001175986853_p1294420220114"><a name="zh-cn_topic_0000001175986853_p1294420220114"></a><a name="zh-cn_topic_0000001175986853_p1294420220114"></a>Uint8Array | string | number | boolean</p> 47 </td> 48 <td class="cellrowborder" valign="top" width="58.78%" headers="mcps1.1.4.1.3 "><p id="zh-cn_topic_0000001175986853_p248495010524"><a name="zh-cn_topic_0000001175986853_p248495010524"></a><a name="zh-cn_topic_0000001175986853_p248495010524"></a>存储的新值。支持Uint8Array、number 、 string 、boolean。</p> 49 <p id="zh-cn_topic_0000001175986853_p89451526118"><a name="zh-cn_topic_0000001175986853_p89451526118"></a><a name="zh-cn_topic_0000001175986853_p89451526118"></a>Uint8Array的长度小于4M。</p> 50 </td> 51 </tr> 52 <tr id="zh-cn_topic_0000001175986853_row109451529112"><td class="cellrowborder" valign="top" width="16.54%" headers="mcps1.1.4.1.1 "><p id="zh-cn_topic_0000001175986853_p1494552214"><a name="zh-cn_topic_0000001175986853_p1494552214"></a><a name="zh-cn_topic_0000001175986853_p1494552214"></a>callback</p> 53 </td> 54 <td class="cellrowborder" valign="top" width="24.68%" headers="mcps1.1.4.1.2 "><p id="zh-cn_topic_0000001175986853_p19455210120"><a name="zh-cn_topic_0000001175986853_p19455210120"></a><a name="zh-cn_topic_0000001175986853_p19455210120"></a>AsyncCallback<void></p> 55 </td> 56 <td class="cellrowborder" valign="top" width="58.78%" headers="mcps1.1.4.1.3 "><p id="zh-cn_topic_0000001175986853_p139457210111"><a name="zh-cn_topic_0000001175986853_p139457210111"></a><a name="zh-cn_topic_0000001175986853_p139457210111"></a>回调函数。</p> 57 </td> 58 </tr> 59 </tbody> 60 </table> 61 62- 返回值： 63 64 无 65 66- 示例 67 68 ``` 69 kvStore.put('key-001', 'value-001', function(err, value){ 70 }); 71 ``` 72 73 74### put\(key: string, value: Uint8Array | string | number | boolean\): Promise<void\><a name="zh-cn_topic_0000001175986853_section43065440019"></a> 75 76添加指定类型键值对到数据库。 77 78此方法是异步promise方法。 79 80- 参数： 81 82 <a name="zh-cn_topic_0000001175986853_table794711212116"></a> 83 <table><thead align="left"><tr id="zh-cn_topic_0000001175986853_row3947021118"><th class="cellrowborder" valign="top" width="16.54%" id="mcps1.1.4.1.1"><p id="zh-cn_topic_0000001175986853_p99471028116"><a name="zh-cn_topic_0000001175986853_p99471028116"></a><a name="zh-cn_topic_0000001175986853_p99471028116"></a>参数名</p> 84 </th> 85 <th class="cellrowborder" valign="top" width="24.68%" id="mcps1.1.4.1.2"><p id="zh-cn_topic_0000001175986853_p169471620118"><a name="zh-cn_topic_0000001175986853_p169471620118"></a><a name="zh-cn_topic_0000001175986853_p169471620118"></a>类型</p> 86 </th> 87 <th class="cellrowborder" valign="top" width="58.78%" id="mcps1.1.4.1.3"><p id="zh-cn_topic_0000001175986853_p119481921315"><a name="zh-cn_topic_0000001175986853_p119481921315"></a><a name="zh-cn_topic_0000001175986853_p119481921315"></a>说明</p> 88 </th> 89 </tr> 90 </thead> 91 <tbody><tr id="zh-cn_topic_0000001175986853_row7948820112"><td class="cellrowborder" valign="top" width="16.54%" headers="mcps1.1.4.1.1 "><p id="zh-cn_topic_0000001175986853_p109481021916"><a name="zh-cn_topic_0000001175986853_p109481021916"></a><a name="zh-cn_topic_0000001175986853_p109481021916"></a>key</p> 92 </td> 93 <td class="cellrowborder" valign="top" width="24.68%" headers="mcps1.1.4.1.2 "><p id="zh-cn_topic_0000001175986853_p1694816216111"><a name="zh-cn_topic_0000001175986853_p1694816216111"></a><a name="zh-cn_topic_0000001175986853_p1694816216111"></a>string</p> 94 </td> 95 <td class="cellrowborder" valign="top" width="58.78%" headers="mcps1.1.4.1.3 "><p id="zh-cn_topic_0000001175986853_p119481124114"><a name="zh-cn_topic_0000001175986853_p119481124114"></a><a name="zh-cn_topic_0000001175986853_p119481124114"></a>要添加数据的key。不能为空且长度不大于1KB。</p> 96 </td> 97 </tr> 98 <tr id="zh-cn_topic_0000001175986853_row1948112913"><td class="cellrowborder" valign="top" width="16.54%" headers="mcps1.1.4.1.1 "><p id="zh-cn_topic_0000001175986853_p19948824120"><a name="zh-cn_topic_0000001175986853_p19948824120"></a><a name="zh-cn_topic_0000001175986853_p19948824120"></a>value</p> 99 </td> 100 <td class="cellrowborder" valign="top" width="24.68%" headers="mcps1.1.4.1.2 "><p id="zh-cn_topic_0000001175986853_p694910210110"><a name="zh-cn_topic_0000001175986853_p694910210110"></a><a name="zh-cn_topic_0000001175986853_p694910210110"></a>Uint8Array | string | number | boolean</p> 101 </td> 102 <td class="cellrowborder" valign="top" width="58.78%" headers="mcps1.1.4.1.3 "><p id="zh-cn_topic_0000001175986853_p794962318"><a name="zh-cn_topic_0000001175986853_p794962318"></a><a name="zh-cn_topic_0000001175986853_p794962318"></a>要添加的数据。支持Uint8Array、number 、 string 、boolean。</p> 103 <p id="zh-cn_topic_0000001175986853_p19822171715312"><a name="zh-cn_topic_0000001175986853_p19822171715312"></a><a name="zh-cn_topic_0000001175986853_p19822171715312"></a>Uint8Array和string类型的value长度必须小于4MB。</p> 104 </td> 105 </tr> 106 </tbody> 107 </table> 108 109- 返回值： 110 111 <a name="zh-cn_topic_0000001175986853_table59499217114"></a> 112 <table><thead align="left"><tr id="zh-cn_topic_0000001175986853_row5949322117"><th class="cellrowborder" valign="top" width="17.01%" id="mcps1.1.3.1.1"><p id="zh-cn_topic_0000001175986853_p129505214113"><a name="zh-cn_topic_0000001175986853_p129505214113"></a><a name="zh-cn_topic_0000001175986853_p129505214113"></a>类型</p> 113 </th> 114 <th class="cellrowborder" valign="top" width="82.99%" id="mcps1.1.3.1.2"><p id="zh-cn_topic_0000001175986853_p395018214112"><a name="zh-cn_topic_0000001175986853_p395018214112"></a><a name="zh-cn_topic_0000001175986853_p395018214112"></a>说明</p> 115 </th> 116 </tr> 117 </thead> 118 <tbody><tr id="zh-cn_topic_0000001175986853_row9950162310"><td class="cellrowborder" valign="top" width="17.01%" headers="mcps1.1.3.1.1 "><p id="zh-cn_topic_0000001175986853_p149501621616"><a name="zh-cn_topic_0000001175986853_p149501621616"></a><a name="zh-cn_topic_0000001175986853_p149501621616"></a>Promise<void></p> 119 </td> 120 <td class="cellrowborder" valign="top" width="82.99%" headers="mcps1.1.3.1.2 "><p id="zh-cn_topic_0000001175986853_p1695072011"><a name="zh-cn_topic_0000001175986853_p1695072011"></a><a name="zh-cn_topic_0000001175986853_p1695072011"></a>Promise实例，用于异步处理。</p> 121 </td> 122 </tr> 123 </tbody> 124 </table> 125 126 127- 示例 128 129 ``` 130 const promise = kvStore.put('key-001', 'value-001'); 131 promise.then((data) => { 132 }).catch((err) => { 133 }); 134 ``` 135 136 137### delete\(key: string, callback: AsyncCallback<void\>\): void<a name="zh-cn_topic_0000001175986853_section15564125555713"></a> 138 139从数据库中删除指定键值的数据。 140 141此方法是异步callback方法。 142 143- 参数： 144 145 <a name="zh-cn_topic_0000001175986853_table19564125545715"></a> 146 <table><thead align="left"><tr id="zh-cn_topic_0000001175986853_row5565135518577"><th class="cellrowborder" valign="top" width="16.54%" id="mcps1.1.4.1.1"><p id="zh-cn_topic_0000001175986853_p1856518555576"><a name="zh-cn_topic_0000001175986853_p1856518555576"></a><a name="zh-cn_topic_0000001175986853_p1856518555576"></a>参数名</p> 147 </th> 148 <th class="cellrowborder" valign="top" width="24.68%" id="mcps1.1.4.1.2"><p id="zh-cn_topic_0000001175986853_p10565105518570"><a name="zh-cn_topic_0000001175986853_p10565105518570"></a><a name="zh-cn_topic_0000001175986853_p10565105518570"></a>类型</p> 149 </th> 150 <th class="cellrowborder" valign="top" width="58.78%" id="mcps1.1.4.1.3"><p id="zh-cn_topic_0000001175986853_p356525525718"><a name="zh-cn_topic_0000001175986853_p356525525718"></a><a name="zh-cn_topic_0000001175986853_p356525525718"></a>说明</p> 151 </th> 152 </tr> 153 </thead> 154 <tbody><tr id="zh-cn_topic_0000001175986853_row1756535515573"><td class="cellrowborder" valign="top" width="16.54%" headers="mcps1.1.4.1.1 "><p id="zh-cn_topic_0000001175986853_p17565125525717"><a name="zh-cn_topic_0000001175986853_p17565125525717"></a><a name="zh-cn_topic_0000001175986853_p17565125525717"></a>key</p> 155 </td> 156 <td class="cellrowborder" valign="top" width="24.68%" headers="mcps1.1.4.1.2 "><p id="zh-cn_topic_0000001175986853_p1156514559576"><a name="zh-cn_topic_0000001175986853_p1156514559576"></a><a name="zh-cn_topic_0000001175986853_p1156514559576"></a>string</p> 157 </td> 158 <td class="cellrowborder" valign="top" width="58.78%" headers="mcps1.1.4.1.3 "><p id="zh-cn_topic_0000001175986853_p9565145511574"><a name="zh-cn_topic_0000001175986853_p9565145511574"></a><a name="zh-cn_topic_0000001175986853_p9565145511574"></a>要删除数据的key。不能为空且长度不大于1KB。</p> 159 </td> 160 </tr> 161 <tr id="zh-cn_topic_0000001175986853_row175661255105713"><td class="cellrowborder" valign="top" width="16.54%" headers="mcps1.1.4.1.1 "><p id="zh-cn_topic_0000001175986853_p15566135505713"><a name="zh-cn_topic_0000001175986853_p15566135505713"></a><a name="zh-cn_topic_0000001175986853_p15566135505713"></a>callback</p> 162 </td> 163 <td class="cellrowborder" valign="top" width="24.68%" headers="mcps1.1.4.1.2 "><p id="zh-cn_topic_0000001175986853_p13566115513572"><a name="zh-cn_topic_0000001175986853_p13566115513572"></a><a name="zh-cn_topic_0000001175986853_p13566115513572"></a>AsyncCallback<void></p> 164 </td> 165 <td class="cellrowborder" valign="top" width="58.78%" headers="mcps1.1.4.1.3 "><p id="zh-cn_topic_0000001175986853_p65661550577"><a name="zh-cn_topic_0000001175986853_p65661550577"></a><a name="zh-cn_topic_0000001175986853_p65661550577"></a>回调函数。</p> 166 </td> 167 </tr> 168 </tbody> 169 </table> 170 171- 返回值： 172 173 无 174 175- 示例 176 177 ``` 178 kvStore.delete('key-001', function(err, value){ 179 }); 180 ``` 181 182 183### delete\(key: string\): Promise<void\><a name="zh-cn_topic_0000001175986853_section1298265189"></a> 184 185从数据库中删除指定键值的数据。 186 187此方法是异步promise方法。 188 189- 参数： 190 191 <a name="zh-cn_topic_0000001175986853_table9983952086"></a> 192 <table><thead align="left"><tr id="zh-cn_topic_0000001175986853_row1798311511811"><th class="cellrowborder" valign="top" width="16.54%" id="mcps1.1.4.1.1"><p id="zh-cn_topic_0000001175986853_p16983145787"><a name="zh-cn_topic_0000001175986853_p16983145787"></a><a name="zh-cn_topic_0000001175986853_p16983145787"></a>参数名</p> 193 </th> 194 <th class="cellrowborder" valign="top" width="24.68%" id="mcps1.1.4.1.2"><p id="zh-cn_topic_0000001175986853_p15983058812"><a name="zh-cn_topic_0000001175986853_p15983058812"></a><a name="zh-cn_topic_0000001175986853_p15983058812"></a>类型</p> 195 </th> 196 <th class="cellrowborder" valign="top" width="58.78%" id="mcps1.1.4.1.3"><p id="zh-cn_topic_0000001175986853_p16984205389"><a name="zh-cn_topic_0000001175986853_p16984205389"></a><a name="zh-cn_topic_0000001175986853_p16984205389"></a>说明</p> 197 </th> 198 </tr> 199 </thead> 200 <tbody><tr id="zh-cn_topic_0000001175986853_row99841511816"><td class="cellrowborder" valign="top" width="16.54%" headers="mcps1.1.4.1.1 "><p id="zh-cn_topic_0000001175986853_p169841354817"><a name="zh-cn_topic_0000001175986853_p169841354817"></a><a name="zh-cn_topic_0000001175986853_p169841354817"></a>key</p> 201 </td> 202 <td class="cellrowborder" valign="top" width="24.68%" headers="mcps1.1.4.1.2 "><p id="zh-cn_topic_0000001175986853_p498416517813"><a name="zh-cn_topic_0000001175986853_p498416517813"></a><a name="zh-cn_topic_0000001175986853_p498416517813"></a>string</p> 203 </td> 204 <td class="cellrowborder" valign="top" width="58.78%" headers="mcps1.1.4.1.3 "><p id="zh-cn_topic_0000001175986853_p19851051887"><a name="zh-cn_topic_0000001175986853_p19851051887"></a><a name="zh-cn_topic_0000001175986853_p19851051887"></a>要删除数据的key。不能为空且长度不大于1KB。</p> 205 </td> 206 </tr> 207 </tbody> 208 </table> 209 210- 返回值： 211 212 <a name="zh-cn_topic_0000001175986853_table898511515811"></a> 213 <table><thead align="left"><tr id="zh-cn_topic_0000001175986853_row1398616518817"><th class="cellrowborder" valign="top" width="17.01%" id="mcps1.1.3.1.1"><p id="zh-cn_topic_0000001175986853_p19860516812"><a name="zh-cn_topic_0000001175986853_p19860516812"></a><a name="zh-cn_topic_0000001175986853_p19860516812"></a>类型</p> 214 </th> 215 <th class="cellrowborder" valign="top" width="82.99%" id="mcps1.1.3.1.2"><p id="zh-cn_topic_0000001175986853_p17986115489"><a name="zh-cn_topic_0000001175986853_p17986115489"></a><a name="zh-cn_topic_0000001175986853_p17986115489"></a>说明</p> 216 </th> 217 </tr> 218 </thead> 219 <tbody><tr id="zh-cn_topic_0000001175986853_row898611514813"><td class="cellrowborder" valign="top" width="17.01%" headers="mcps1.1.3.1.1 "><p id="zh-cn_topic_0000001175986853_p39861451811"><a name="zh-cn_topic_0000001175986853_p39861451811"></a><a name="zh-cn_topic_0000001175986853_p39861451811"></a>Promise<void></p> 220 </td> 221 <td class="cellrowborder" valign="top" width="82.99%" headers="mcps1.1.3.1.2 "><p id="zh-cn_topic_0000001175986853_p69870519814"><a name="zh-cn_topic_0000001175986853_p69870519814"></a><a name="zh-cn_topic_0000001175986853_p69870519814"></a>Promise实例，用于异步处理。</p> 222 </td> 223 </tr> 224 </tbody> 225 </table> 226 227- 示例 228 229 ``` 230 const promise = kvStore.delete('key-001'); 231 promise.then((data) => { 232 }).catch((err) => { 233 }); 234 ``` 235 236 237### on\(event: 'dataChange', type: SubscribeType, observer: Callback<ChangeNotification\>\): void<a name="zh-cn_topic_0000001175986853_section9748071812"></a> 238 239订阅指定类型的数据更改通知。 240 241此方法是同步方法。 242 243- 参数： 244 245 <a name="zh-cn_topic_0000001175986853_table074609186"></a> 246 <table><thead align="left"><tr id="zh-cn_topic_0000001175986853_row1274120111815"><th class="cellrowborder" valign="top" width="16.54%" id="mcps1.1.4.1.1"><p id="zh-cn_topic_0000001175986853_p18751803180"><a name="zh-cn_topic_0000001175986853_p18751803180"></a><a name="zh-cn_topic_0000001175986853_p18751803180"></a>参数名</p> 247 </th> 248 <th class="cellrowborder" valign="top" width="35.14%" id="mcps1.1.4.1.2"><p id="zh-cn_topic_0000001175986853_p13752021816"><a name="zh-cn_topic_0000001175986853_p13752021816"></a><a name="zh-cn_topic_0000001175986853_p13752021816"></a>类型</p> 249 </th> 250 <th class="cellrowborder" valign="top" width="48.32%" id="mcps1.1.4.1.3"><p id="zh-cn_topic_0000001175986853_p17751081815"><a name="zh-cn_topic_0000001175986853_p17751081815"></a><a name="zh-cn_topic_0000001175986853_p17751081815"></a>说明</p> 251 </th> 252 </tr> 253 </thead> 254 <tbody><tr id="zh-cn_topic_0000001175986853_row8751009186"><td class="cellrowborder" valign="top" width="16.54%" headers="mcps1.1.4.1.1 "><p id="zh-cn_topic_0000001175986853_p17752091815"><a name="zh-cn_topic_0000001175986853_p17752091815"></a><a name="zh-cn_topic_0000001175986853_p17752091815"></a>event</p> 255 </td> 256 <td class="cellrowborder" valign="top" width="35.14%" headers="mcps1.1.4.1.2 "><p id="zh-cn_topic_0000001175986853_p1675120191811"><a name="zh-cn_topic_0000001175986853_p1675120191811"></a><a name="zh-cn_topic_0000001175986853_p1675120191811"></a>'dataChange'</p> 257 </td> 258 <td class="cellrowborder" valign="top" width="48.32%" headers="mcps1.1.4.1.3 "><p id="zh-cn_topic_0000001175986853_p9755012181"><a name="zh-cn_topic_0000001175986853_p9755012181"></a><a name="zh-cn_topic_0000001175986853_p9755012181"></a>回调函数名称。</p> 259 </td> 260 </tr> 261 <tr id="zh-cn_topic_0000001175986853_row5751709182"><td class="cellrowborder" valign="top" width="16.54%" headers="mcps1.1.4.1.1 "><p id="zh-cn_topic_0000001175986853_p17751602182"><a name="zh-cn_topic_0000001175986853_p17751602182"></a><a name="zh-cn_topic_0000001175986853_p17751602182"></a>type</p> 262 </td> 263 <td class="cellrowborder" valign="top" width="35.14%" headers="mcps1.1.4.1.2 "><p id="zh-cn_topic_0000001175986853_p137613011189"><a name="zh-cn_topic_0000001175986853_p137613011189"></a><a name="zh-cn_topic_0000001175986853_p137613011189"></a><a href="js-apis-data-type.md#zh-cn_topic_0000001129943828_section099619567453">SubscribeType</a></p> 264 </td> 265 <td class="cellrowborder" valign="top" width="48.32%" headers="mcps1.1.4.1.3 "><p id="zh-cn_topic_0000001175986853_p117616061817"><a name="zh-cn_topic_0000001175986853_p117616061817"></a><a name="zh-cn_topic_0000001175986853_p117616061817"></a>表示订阅的类型。具体参考SubscribeType。</p> 266 </td> 267 </tr> 268 <tr id="zh-cn_topic_0000001175986853_row476140141813"><td class="cellrowborder" valign="top" width="16.54%" headers="mcps1.1.4.1.1 "><p id="zh-cn_topic_0000001175986853_p16768011189"><a name="zh-cn_topic_0000001175986853_p16768011189"></a><a name="zh-cn_topic_0000001175986853_p16768011189"></a>observer</p> 269 </td> 270 <td class="cellrowborder" valign="top" width="35.14%" headers="mcps1.1.4.1.2 "><p id="zh-cn_topic_0000001175986853_p107614014186"><a name="zh-cn_topic_0000001175986853_p107614014186"></a><a name="zh-cn_topic_0000001175986853_p107614014186"></a>Callback<<a href="js-apis-data-type.md#zh-cn_topic_0000001129943828_section9868357105716">ChangeNotification</a>></p> 271 </td> 272 <td class="cellrowborder" valign="top" width="48.32%" headers="mcps1.1.4.1.3 "><p id="zh-cn_topic_0000001175986853_p576180111819"><a name="zh-cn_topic_0000001175986853_p576180111819"></a><a name="zh-cn_topic_0000001175986853_p576180111819"></a>回调函数。</p> 273 </td> 274 </tr> 275 </tbody> 276 </table> 277 278- 返回值： 279 280 无 281 282- 示例 283 284 ``` 285 kvStore.on('dataChange', 0, function(notification){ 286 }); 287 ``` 288 289 290### on\(event: 'syncComplete', syncCallback: Callback<Array<\[string, number\]\>\>\): void<a name="zh-cn_topic_0000001175986853_section06419235582"></a> 291 292订阅指定类型的数据更改通知。 293 294此方法是同步方法。 295 296- 参数： 297 298 <a name="zh-cn_topic_0000001175986853_table16642172313584"></a> 299 <table><thead align="left"><tr id="zh-cn_topic_0000001175986853_row1064292310587"><th class="cellrowborder" valign="top" width="16.54%" id="mcps1.1.4.1.1"><p id="zh-cn_topic_0000001175986853_p9642172345810"><a name="zh-cn_topic_0000001175986853_p9642172345810"></a><a name="zh-cn_topic_0000001175986853_p9642172345810"></a>参数名</p> 300 </th> 301 <th class="cellrowborder" valign="top" width="40.160000000000004%" id="mcps1.1.4.1.2"><p id="zh-cn_topic_0000001175986853_p1264242365813"><a name="zh-cn_topic_0000001175986853_p1264242365813"></a><a name="zh-cn_topic_0000001175986853_p1264242365813"></a>类型</p> 302 </th> 303 <th class="cellrowborder" valign="top" width="43.3%" id="mcps1.1.4.1.3"><p id="zh-cn_topic_0000001175986853_p16426231582"><a name="zh-cn_topic_0000001175986853_p16426231582"></a><a name="zh-cn_topic_0000001175986853_p16426231582"></a>说明</p> 304 </th> 305 </tr> 306 </thead> 307 <tbody><tr id="zh-cn_topic_0000001175986853_row196421223165820"><td class="cellrowborder" valign="top" width="16.54%" headers="mcps1.1.4.1.1 "><p id="zh-cn_topic_0000001175986853_p13944834181016"><a name="zh-cn_topic_0000001175986853_p13944834181016"></a><a name="zh-cn_topic_0000001175986853_p13944834181016"></a>event</p> 308 </td> 309 <td class="cellrowborder" valign="top" width="40.160000000000004%" headers="mcps1.1.4.1.2 "><p id="zh-cn_topic_0000001175986853_p14715174110107"><a name="zh-cn_topic_0000001175986853_p14715174110107"></a><a name="zh-cn_topic_0000001175986853_p14715174110107"></a>'syncComplete'</p> 310 </td> 311 <td class="cellrowborder" valign="top" width="43.3%" headers="mcps1.1.4.1.3 "><p id="zh-cn_topic_0000001175986853_p564282316586"><a name="zh-cn_topic_0000001175986853_p564282316586"></a><a name="zh-cn_topic_0000001175986853_p564282316586"></a>回调函数名称。</p> 312 </td> 313 </tr> 314 <tr id="zh-cn_topic_0000001175986853_row629323499"><td class="cellrowborder" valign="top" width="16.54%" headers="mcps1.1.4.1.1 "><p id="zh-cn_topic_0000001175986853_p629393496"><a name="zh-cn_topic_0000001175986853_p629393496"></a><a name="zh-cn_topic_0000001175986853_p629393496"></a>syncCallback</p> 315 </td> 316 <td class="cellrowborder" valign="top" width="40.160000000000004%" headers="mcps1.1.4.1.2 "><p id="zh-cn_topic_0000001175986853_p92931231917"><a name="zh-cn_topic_0000001175986853_p92931231917"></a><a name="zh-cn_topic_0000001175986853_p92931231917"></a>Callback<Array<[string, number]>></p> 317 </td> 318 <td class="cellrowborder" valign="top" width="43.3%" headers="mcps1.1.4.1.3 "><p id="zh-cn_topic_0000001175986853_p529433197"><a name="zh-cn_topic_0000001175986853_p529433197"></a><a name="zh-cn_topic_0000001175986853_p529433197"></a>回调函数。</p> 319 </td> 320 </tr> 321 </tbody> 322 </table> 323 324- 返回值： 325 326 无 327 328- 示例 329 330 ``` 331 kvStore.on('syncComplete', function(data){ 332 }); 333 ``` 334 335 336
