Telegram 小程序 | TypeScript @telegram-apps/sdk @2.x | 组件 | 云存储

riyad

云存储​

负责管理 Telegram 迷你应用程序中云存储的💠组件。

检查支持​

要检查当前 Telegram 迷你应用程序版本是否支持云存储，需要使用 isSupported 方法：

Variable :

1. import { cloudStorage } from '@telegram-apps/sdk';
   
2. 
   - t# {0 c4 n8 C* z$ T  f3 e
3. cloudStorage.isSupported(); // boolean

复制代码

Functions :

1. import { isCloudStorageSupported } from '@telegram-apps/sdk';
   + r( H6 ~1 {, \6 ^
2. 
   
3. isCloudStorageSupported(); // boolean

复制代码

设置项目​

要设置键值，请使用 setItem 方法。

Variable :

1. await cloudStorage.setItem('a', 'a-value');

复制代码

Functions :

1. import { setCloudStorageItem } from '@telegram-apps/sdk';
   
2. 
   
3. await setCloudStorageItem('a', 'a-value');

复制代码

获取钥匙​

要获取所有现有密钥的列表，请使用 getKeys 方法。

Variable :

1. const keys = await cloudStorage.getKeys(); // ['a', 'b', 'c']

复制代码

Functions :

1. import { getCloudStorageKeys } from '@telegram-apps/sdk';
   / \, @! ^* e. q. A9 R5 l
2. 
   
3. const keys = await getCloudStorageKeys(); // ['a', 'b', 'c']

复制代码

7 _) Z( |% I) ?+ s3 p

要获取特定键或多个键的值，请使用 getItem 方法。

Variable :

1. const nonExistent = await cloudStorage.getItem('non-existent');
   
2. // The result is an empty string: ''
   
3. 
   , L# O5 e& S* w# Z1 x4 B
4. const existent = await cloudStorage.getItem('a');
   
5. // The result is the value of the 'a' key. Example: 'a-value'
   
6. 
   
7. const values = await cloudStorage.getItem(['a', 'b', 'non-existent']);
   
8. // The result is a record of the keys 'a', 'b', and 'non-existent'.
   
9. // Example:
   % m9 u8 S0 G2 ~1 M" B
10. // {
    
11. //   a: 'a-value',
    
12. //   b: 'b-value',
    
13. //   'non-existent': '',
    
14. // }

复制代码

Functions :

1. import { getCloudStorageItem } from '@telegram-apps/sdk';
   $ m$ `% Q$ H6 {% R4 C9 E! F' |
2. 
   . i8 \- p) Q& Z- B
3. const nonExistent = await getCloudStorageItem('non-existent');
   & R1 ~! ~3 r9 l1 L+ W' l
4. // The result is an empty string: ''
   
5. 
   
6. const existent = await getCloudStorageItem('a');
   / H! I9 a9 x" N/ [  N9 F( L- U# Z2 b
7. // The result is the value of the 'a' key. Example: 'a-value'
   
8. 
   ! t* t  N& J% \& \
9. const values = await getCloudStorageItem(['a', 'b', 'non-existent']);
   . p" q- u& M6 \
10. // The result is a record of the keys 'a', 'b', and 'non-existent'.
    6 E0 A3 \  w, Z; a7 J5 p
11. // Example:
    2 y" i+ Z) L, Q( N9 `% d
12. // {
    
13. //   a: 'a-value',
    
14. //   b: 'b-value',
    # Z2 a' F" t6 k3 e$ f$ k/ k3 c$ ~; d. ]
15. //   'non-existent': '',
    
16. // }

复制代码

删除项目​

要删除一个键或键列表，请使用 deleteItem 方法。

Variable :

1. await cloudStorage.deleteItem('a');
   
2. await cloudStorage.deleteItem(['a', 'b', 'c']);

复制代码

Functions :

1. import { deleteCloudStorageItem } from '@telegram-apps/sdk';
   ; Y8 H" V6 V$ x2 I6 d& S* o1 ]
2. 
   # K; v6 n+ d" K' @4 Y
3. await deleteCloudStorageItem('a');
   
4. await deleteCloudStorageItem(['a', 'b', 'c']);

复制代码