1# 查询密钥别名集(ArkTS)
2
3
4HUKS提供了接口供应用查询密钥别名集。
5>**说明：**
6> 轻量级设备不支持查询密钥别名集功能。
7
8
9## 开发步骤
10
111. 初始化密钥属性集。用于查询指定密钥别名集TAG，TAG仅支持[HUKS_TAG_AUTH_STORAGE_LEVEL](../../reference/apis-universal-keystore-kit/_huks_type_api.md#oh_huks_authstoragelevel)。
12
132. 调用接口[listAliases](../../reference/apis-universal-keystore-kit/js-apis-huks.md#hukslistaliases12)，查密钥别名集。
14
15```ts
16/*
17 * 以下查询密钥别名集Promise操作使用为例
18 */
19import { huks } from '@kit.UniversalKeystoreKit'
20
21async function testListAliases() {
22  /* 1.初始化密钥属性集 */
23  let queryProperties: Array<huks.HuksParam> = [
24    {
25      tag: huks.HuksTag.HUKS_TAG_AUTH_STORAGE_LEVEL,
26      value: huks.HuksAuthStorageLevel.HUKS_AUTH_STORAGE_LEVEL_DE
27    }
28  ];
29  let queryOptions: huks.HuksOptions = {
30    properties: queryProperties
31  };
32
33  try {
34    /* 2.查询密钥别名集 */
35    let result: huks.HuksListAliasesReturnResult = await huks.listAliases(queryOptions);
36    console.info(`promise: listAliases success`);
37  } catch (error) {
38    console.error(`promise: listAliases fail`);
39  }
40}
41```