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

riyad

云存储​

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

检查支持​

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

Variable :

1. import { cloudStorage } from '@telegram-apps/sdk';
   1 L. l4 V  l* B  d5 E+ `3 l2 H2 X+ q
2. 
   - m' L" J8 N, r; G
3. cloudStorage.isSupported(); // boolean

复制代码

Functions :

1. import { isCloudStorageSupported } from '@telegram-apps/sdk';
   
2. 
   % i8 X" s; \4 ~# P, C) S. E( U% X
3. isCloudStorageSupported(); // boolean

复制代码

设置项目​

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

Variable :

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

复制代码

Functions :

1. import { setCloudStorageItem } from '@telegram-apps/sdk';
   
2. 
   / J1 T% M" y8 n% Y
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. 
   " z! f2 O+ F  T! s) X+ q! P
3. const keys = await getCloudStorageKeys(); // ['a', 'b', 'c']

复制代码

2 l) R7 u% K0 Y( B. M9 I  i6 k: \

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

Variable :

1. const nonExistent = await cloudStorage.getItem('non-existent');
   
2. // The result is an empty string: ''
   : M0 e1 b  D1 L- W, f8 W3 O
3. 
   ) W/ I1 {5 ^1 I3 r) g
4. const existent = await cloudStorage.getItem('a');
   9 ]: G  o7 T: \
5. // The result is the value of the 'a' key. Example: 'a-value'
   6 B4 c& O2 F: p3 S& p
6. 
   
7. const values = await cloudStorage.getItem(['a', 'b', 'non-existent']);
   ( R; A! H; P( F* q- R: g/ Y
8. // The result is a record of the keys 'a', 'b', and 'non-existent'.
   2 i  M' c# w, @" n7 z5 a
9. // Example:
   + q, j. Q+ {) x1 i! _
10. // {
    + _8 l  |$ W- ]( v( A! a6 B3 o
11. //   a: 'a-value',
    ( Z4 d8 ^5 b" ]4 L" r9 e% @+ A
12. //   b: 'b-value',
    
13. //   'non-existent': '',
    
14. // }

复制代码

Functions :

1. import { getCloudStorageItem } from '@telegram-apps/sdk';
   
2. 
   / t; F' O. \! ]8 [3 `4 }: K
3. const nonExistent = await getCloudStorageItem('non-existent');
   
4. // The result is an empty string: ''
     Q+ q$ l* B1 x  y. T6 A3 a; A
5. 
   
6. const existent = await getCloudStorageItem('a');
   . N  n# a6 m( ]; P. G
7. // The result is the value of the 'a' key. Example: 'a-value'
     f5 G% Y- A; J
8. 
   $ c2 o& s8 u9 ^8 ]) D: \
9. const values = await getCloudStorageItem(['a', 'b', 'non-existent']);
   
10. // The result is a record of the keys 'a', 'b', and 'non-existent'.
    ! T. D4 t& A5 x
11. // Example:
    
12. // {
    
13. //   a: 'a-value',
    : J. q3 Q! l/ p0 X: c! c4 u
14. //   b: 'b-value',
    6 i; F" N: P( O, J  o4 I
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';
   
2. 
   
3. await deleteCloudStorageItem('a');
   + ]& y; \! H$ K' H) _: n
4. await deleteCloudStorageItem(['a', 'b', 'c']);

复制代码

7 B$ ^3 u- ?* i, `/ V