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

riyad

云存储​

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

检查支持​

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

Variable :

1. import { cloudStorage } from '@telegram-apps/sdk';
   4 ~- o  U* z3 ^% _+ |0 h- Z& c
2. 
   6 U1 t. M( G. g# e7 C( h. K9 \; b
3. cloudStorage.isSupported(); // boolean

复制代码

5 \1 E4 q5 i: M: R! ]

Functions :

1. import { isCloudStorageSupported } from '@telegram-apps/sdk';
   6 c5 G9 {( `5 ?. r. ?
2. 
   ! a- c0 G4 {/ _, z+ {" w/ M8 ?$ r4 S
3. isCloudStorageSupported(); // boolean

复制代码

设置项目​

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

Variable :

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

复制代码

Functions :

1. import { setCloudStorageItem } from '@telegram-apps/sdk';
   # {: g6 `0 W6 f
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';
   
2. 
   0 E( S2 _& P+ t& J8 @1 c# D
3. const keys = await getCloudStorageKeys(); // ['a', 'b', 'c']

复制代码

: G# r+ F% K$ B3 U& u; N9 p

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

Variable :

1. const nonExistent = await cloudStorage.getItem('non-existent');
   
2. // The result is an empty string: ''
   + ^7 ~; i0 I* h, x
3. 
   
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'.
   / v- K0 @- Z0 y( D
9. // Example:
   / Y! E) ]4 [, F- h
10. // {
    
11. //   a: 'a-value',
    
12. //   b: 'b-value',
    4 ?( I$ S, x# f* y1 `- l; y7 M
13. //   'non-existent': '',
    * X3 m) M; k9 X' I! E$ o6 M/ b2 \6 S
14. // }

复制代码

Functions :

1. import { getCloudStorageItem } from '@telegram-apps/sdk';
   , h( S( c  ^$ T. O! U8 P
2. 
   2 `% f2 N+ R0 W: M
3. const nonExistent = await getCloudStorageItem('non-existent');
   8 t1 q. P6 D0 K* Z& c- T" V% g2 ~
4. // The result is an empty string: ''
   8 r$ `  b) Q" C) ?4 R2 a& X( B
5. 
   5 B0 g( ^: i1 e
6. const existent = await getCloudStorageItem('a');
   
7. // The result is the value of the 'a' key. Example: 'a-value'
   * a+ m2 {; ~" b% {, G. [3 Y* @
8. 
   7 I, M$ [: b9 b: M
9. const values = await getCloudStorageItem(['a', 'b', 'non-existent']);
   
10. // The result is a record of the keys 'a', 'b', and 'non-existent'.
    4 @4 I) `9 T6 \( ?1 ~) M5 q0 q
11. // Example:
    * A0 g" @3 h7 ^$ j- D3 y
12. // {
    - d9 m) b; L6 w' S/ G
13. //   a: 'a-value',
    
14. //   b: 'b-value',
    
15. //   'non-existent': '',
    
16. // }

复制代码

删除项目​

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

Variable :

1. await cloudStorage.deleteItem('a');
   " D0 N! K: [) L2 F2 n
2. await cloudStorage.deleteItem(['a', 'b', 'c']);

复制代码

Functions :

1. import { deleteCloudStorageItem } from '@telegram-apps/sdk';
   ; d3 }5 A- \4 M9 B  U1 c2 O8 b  b
2. 
   
3. await deleteCloudStorageItem('a');
   
4. await deleteCloudStorageItem(['a', 'b', 'c']);

复制代码