xref: /docs/en/application-dev/reference/apis-basic-services-kit/js-apis-configPolicy-sys.md (revision e41f4b71)

# @ohos.configPolicy (Configuration Policy) (System API)

The **configPolicy** module provides APIs for obtaining the custom configuration directory and file path based on the predefined configuration level.

>  **NOTE**
>
>  The initial APIs of this module are supported since API version 8. Newly added APIs will be marked with a superscript to indicate their earliest API version.
>
>  The APIs provided by this module are system APIs.

## Modules to Import

```ts
import configPolicy from '@ohos.configPolicy';
```

## getOneCfgFile

getOneCfgFile(relPath: string, callback: AsyncCallback<string>)

Obtains the path of the configuration file with the highest priority based on the specified file name. This API uses an asynchronous callback to return the result.
If there are two **config.xml** files, **/system/etc/config.xml** and **/sys_pod/etc/config.xml**, in ascending order of priority, **/sys_pod/etc/config.xml** is returned.

**System capability**: SystemCapability.Customization.ConfigPolicy

**Parameters**

| Name  | Type                       | Mandatory| Description                                      |
| -------- | --------------------------- | ---- | ------------------------------------------ |
| relPath  | string                      | Yes  | Name of the configuration file.                                |
| callback | AsyncCallback<string> | Yes  | Callback used to return the path of the configuration file.|

**Error codes**

For details about the error codes, see [Universal Error Codes](../errorcode-universal.md).

| ID| Error Message                                                                      |
| ------- | ---------------------------------------------------------------------------- |
| 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.|

**Example**

  ```ts
  import { BusinessError } from '@ohos.base';

  try {
    let relpath: string = 'etc/config.xml';
    configPolicy.getOneCfgFile(relpath, (error: BusinessError, value: string) => {
      if (error == null) {
        console.log('value is ' + value);
      } else {
        console.log('error occurs ' + error);
      }
    });
  } catch (error) {
    let code = (error as BusinessError).code;
    let message = (error as BusinessError).message;
    console.log('error:' + code + ',' + message);
  }
  ```

## getOneCfgFile

getOneCfgFile(relPath: string): Promise<string>

Obtains the path of the configuration file with the highest priority based on the specified file name. This API uses a promise to return the result.

**System capability**: SystemCapability.Customization.ConfigPolicy

**Parameters**

| Name | Type  | Mandatory| Description      |
| ------- | ------ | ---- | ---------- |
| relPath | string | Yes  | Name of the configuration file.|

**Error codes**

For details about the error codes, see [Universal Error Codes](../errorcode-universal.md).

| ID| Error Message                                                                      |
| ------- | ---------------------------------------------------------------------------- |
| 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.|

**Return value**

| Type                  | Description                    |
| ---------------------- | ------------------------ |
| Promise<string>  | Promise used to return the path of the configuration file.|

**Example**

  ```ts
  import { BusinessError } from '@ohos.base';

  try {
    let relpath: string = 'etc/config.xml';
    configPolicy.getOneCfgFile(relpath).then((value: string) => {
      console.log('value is ' + value);
    }).catch((error: BusinessError) => {
      console.log('getOneCfgFile promise ' + error);
    });
  } catch (error) {
    let code = (error as BusinessError).code;
    let message = (error as BusinessError).message;
    console.log('error:' + code + ',' + message);
  }
  ```

## getCfgFiles

getCfgFiles(relPath: string, callback: AsyncCallback<Array<string>>)

Obtains a list of configuration files with the specified name, sorted in ascending order of priority. This API uses an asynchronous callback to return the result.
If there are two **config.xml** files, **/system/etc/config.xml** and **/sys_pod/etc/config.xml**, in ascending order of priority, **/system/etc/config.xml, /sys_pod/etc/config.xml** is returned.

**System capability**: SystemCapability.Customization.ConfigPolicy

**Parameters**

| Name  | Type                                    | Mandatory| Description                      |
| -------- | ---------------------------------------- | ---- | -------------------------- |
| relPath  | string                                   | Yes  | Name of the configuration file.                |
| callback | AsyncCallback<Array<string>> | Yes  | Callback used to return the file list.|

**Error codes**

For details about the error codes, see [Universal Error Codes](../errorcode-universal.md).

| ID| Error Message                                                                      |
| ------- | ---------------------------------------------------------------------------- |
| 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.|

**Example**

  ```ts
  import { BusinessError } from '@ohos.base';

  try {
    configPolicy.getCfgFiles('etc/config.xml', (error: BusinessError, value: Array<string>) => {
      if (error == null) {
        console.log('value is ' + value);
      } else {
        console.log('error occurs ' + error);
      }
    });
  } catch (error) {
    let code = (error as BusinessError).code;
    let message = (error as BusinessError).message;
    console.log('error:' + code + ',' + message);
  }
  ```

## getCfgFiles

getCfgFiles(relPath: string): Promise&lt;Array&lt;string&gt;&gt;

Obtains a list of configuration files with the specified name, sorted in ascending order of priority. This API uses a promise to return the result.

**System capability**: SystemCapability.Customization.ConfigPolicy

**Parameters**

| Name | Type  | Mandatory| Description      |
| ------- | ------ | ---- | ---------- |
| relPath | string | Yes  | Name of the configuration file.|

**Error codes**

For details about the error codes, see [Universal Error Codes](../errorcode-universal.md).

| ID| Error Message                                                                      |
| ------- | ---------------------------------------------------------------------------- |
| 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.|

**Return value**

| Type                              | Description    |
| ---------------------------------- | -------- |
| Promise&lt;Array&lt;string&gt;&gt; | Promise used to return the file list.|

**Example**

  ```ts
  import { BusinessError } from '@ohos.base';

  try {
    let relpath: string = 'etc/config.xml';
    configPolicy.getCfgFiles(relpath).then((value: Array<string>) => {
      console.log('value is ' + value);
    }).catch((error: BusinessError) => {
      console.log('getCfgFiles promise ' + error);
    });
  } catch (error) {
    let code = (error as BusinessError).code;
    let message = (error as BusinessError).message;
    console.log('error:' + code + ',' + message);
  }
  ```

## getCfgDirList

getCfgDirList(callback: AsyncCallback&lt;Array&lt;string&gt;&gt;)

Obtains the list of configuration level directories. This API uses an asynchronous callback to return the result.

**System capability**: SystemCapability.Customization.ConfigPolicy

**Parameters**

| Name  | Type                                    | Mandatory| Description                              |
| -------- | ---------------------------------------- | ---- | ---------------------------------- |
| callback | AsyncCallback&lt;Array&lt;string&gt;&gt; | Yes  | Callback used to return the configuration level directory list.|

**Error codes**

For details about the error codes, see [Universal Error Codes](../errorcode-universal.md).

| ID| Error Message                                                                      |
| ------- | ---------------------------------------------------------------------------- |
| 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.|

**Example**

  ```ts
  import { BusinessError } from '@ohos.base';

  try {
    configPolicy.getCfgDirList((error: BusinessError, value: Array<string>) => {
      if (error == null) {
        console.log('value is ' + value);
      } else {
        console.log('error occurs ' + error);
      }
    });
  } catch (error) {
    let code = (error as BusinessError).code;
    let message = (error as BusinessError).message;
    console.log('error:' + code + ',' + message);
  }
  ```

## getCfgDirList

getCfgDirList(): Promise&lt;Array&lt;string&gt;&gt;

Obtains the list of configuration level directories. This API uses a promise to return the result.

**System capability**: SystemCapability.Customization.ConfigPolicy

**Return value**

| Type                              | Description            |
| ---------------------------------- | ---------------- |
| Promise&lt;Array&lt;string&gt;&gt; | Promise used to return the configuration level directory list.|

**Example**

  ```ts
  import { BusinessError } from '@ohos.base';

  try {
    configPolicy.getCfgDirList().then((value: Array<string>) => {
      console.log('value is ' + value);
    }).catch((error: BusinessError) => {
      console.log('getCfgDirList promise ' + error);
    });
  } catch (error) {
    let code = (error as BusinessError).code;
    let message = (error as BusinessError).message;
    console.log('error:' + code + ',' + message);
  }
  ```

## getOneCfgFile<sup>11+</sup>

getOneCfgFile(relPath: string, followMode: FollowXMode, callback: AsyncCallback&lt;string&gt;)

Obtains the path of the configuration file with the highest priority based on the specified file name and follow mode. This API uses an asynchronous callback to return the result.
For example, there are three **config.xml** files (in ascending order of priority): **/system/etc/config.xml**, **/sys_pod/etc/config.xml**, and **/sys_pod/etc/carrier/46060/etc/config.xml**. If the opkey of the default card is **46060** and the follow mode is **SIM_DEFAULT**, **/sys_pod/etc/carrier/46060/etc/config.xml** is returned.

**System capability**: SystemCapability.Customization.ConfigPolicy

**Parameters**

| Name    | Type                         | Mandatory| Description                                      |
| ---------- | ----------------------------- | ---- | ------------------------------------------ |
| relPath    | string                        | Yes  | Name of the configuration file.                                |
| followMode | [FollowXMode](#followxmode11) | Yes  | Follow mode.                                  |
| callback   | AsyncCallback&lt;string&gt;   | Yes  | Callback used to return the path of the configuration file.|

**Error codes**

For details about the error codes, see [Universal Error Codes](../errorcode-universal.md).

| ID| Error Message                                                                      |
| ------- | ---------------------------------------------------------------------------- |
| 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.|

**Example**

  ```ts
  import { BusinessError } from '@ohos.base';

  try {
    let relpath: string = 'etc/config.xml';
    configPolicy.getOneCfgFile(relpath, configPolicy.FollowXMode.SIM_DEFAULT,
      (error: BusinessError, value: string) => {
      if (error == null) {
        console.log('value is ' + value);
      } else {
        console.log('error occurs ' + error);
      }
    });
  } catch (error) {
    let code = (error as BusinessError).code;
    let message = (error as BusinessError).message;
    console.log('error:' + code + ',' + message);
  }
  ```

## getOneCfgFile<sup>11+</sup>

getOneCfgFile(relPath: string, followMode: FollowXMode, extra: string, callback: AsyncCallback&lt;string&gt;)

Obtains the path of the configuration file with the highest priority based on the specified file name and custom follow rule. This API uses an asynchronous callback to return the result.
For example, there are three **config.xml** files (in ascending order of priority): **/system/etc/config.xml**, **/sys_pod/etc/config.xml**, and **/sys_pod/etc/carrier/46060/etc/config.xml**. If the opkey of card 1 is **46060**, the follow mode is **USER_DEFINED**, and the custom follow rule is **etc/carrier/${telephony.sim.opkey0}**, **/sys_pod/etc/carrier/46060/etc/config.xml** is returned.

**System capability**: SystemCapability.Customization.ConfigPolicy

**Parameters**

| Name    | Type                         | Mandatory| Description                                                  |
| ---------- | ----------------------------- | ---- | ------------------------------------------------------ |
| relPath    | string                        | Yes  | Name of the configuration file.                                            |
| followMode | [FollowXMode](#followxmode11) | Yes  | Follow mode.                                              |
| extra      | string                        | Yes  | Custom follow rule. This parameter is valid only when **followMode** is set to **USER_DEFINED**.|
| callback   | AsyncCallback&lt;string&gt;   | Yes  | Callback used to return the path of the configuration file.            |

**Error codes**

For details about the error codes, see [Universal Error Codes](../errorcode-universal.md).

| ID| Error Message                                                                      |
| ------- | ---------------------------------------------------------------------------- |
| 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.|

**Example**

  ```ts
  import { BusinessError } from '@ohos.base';

  try {
    let relpath: string = 'etc/config.xml';
    let extra: string = 'etc/carrier/${telephony.sim.opkey0}';
    configPolicy.getOneCfgFile(relpath, configPolicy.FollowXMode.USER_DEFINED, extra,
      (error: BusinessError, value: string) => {
      if (error == null) {
        console.log('value is ' + value);
      } else {
        console.log('error occurs ' + error);
      }
    });
  } catch (error) {
    let code = (error as BusinessError).code;
    let message = (error as BusinessError).message;
    console.log('error:' + code + ',' + message);
  }
  ```

## getOneCfgFile<sup>11+</sup>

getOneCfgFile(relPath: string, followMode: FollowXMode, extra?: string): Promise&lt;string&gt;

Obtains the path of the configuration file with the highest priority based on the specified file name and follow mode. This API uses a promise to return the result.

**System capability**: SystemCapability.Customization.ConfigPolicy

**Parameters**

| Name    | Type                         | Mandatory| Description                                                  |
| ---------- | ----------------------------- | ---- | ------------------------------------------------------ |
| relPath    | string                        | Yes  | Name of the configuration file.                                            |
| followMode | [FollowXMode](#followxmode11) | Yes  | Follow mode.                                              |
| extra      | string                        | No  | Custom follow rule. This parameter is valid only when **followMode** is set to **USER_DEFINED**.|

**Error codes**

For details about the error codes, see [Universal Error Codes](../errorcode-universal.md).

| ID| Error Message                                                                      |
| ------- | ---------------------------------------------------------------------------- |
| 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3.Parameter verification failed.|

**Return value**

| Type                  | Description                    |
| ---------------------- | ------------------------ |
| Promise&lt;string&gt;  | Promise used to return the path of the configuration file.|

**Example**

  ```ts
  import { BusinessError } from '@ohos.base';

  try {
    let relpath: string = 'etc/config.xml';
    let extra: string = 'etc/carrier/${telephony.sim.opkey0}';
    configPolicy.getOneCfgFile(relpath, configPolicy.FollowXMode.SIM_DEFAULT, extra).then((value: string) => {
      console.log('value is ' + value);
    }).catch((error: BusinessError) => {
      console.log('getOneCfgFile promise ' + error);
    });
  } catch (error) {
    let code = (error as BusinessError).code;
    let message = (error as BusinessError).message;
    console.log('error:' + code + ',' + message);
  }
  ```

## getOneCfgFileSync<sup>11+</sup>

getOneCfgFileSync(relPath: string, followMode?: FollowXMode, extra?: string): string

Obtains the path of the configuration file with the highest priority based on the specified file name and follow mode. This API returns the result synchronously.

**System capability**: SystemCapability.Customization.ConfigPolicy

**Parameters**

| Name    | Type                         | Mandatory| Description                                                |
| ---------- | ----------------------------- | ---- | ----------------------------------------------------|
| relPath    | string                        | Yes  | Name of the configuration file.                                          |
| followMode | [FollowXMode](#followxmode11) | No  | Follow mode. The default value is **DEFAULT**.                   |
| extra      | string                        | No  | Custom follow rule. This parameter is valid only when **followMode** is set to **USER_DEFINED**.|

**Error codes**

For details about the error codes, see [Universal Error Codes](../errorcode-universal.md).

| ID| Error Message                                                                      |
| ------- | ---------------------------------------------------------------------------- |
| 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3.Parameter verification failed.|

**Return value**

| Type  | Description                    |
| ------ | ------------------------ |
| string | Promise used to return the path of the configuration file.|


**Example**

  ```ts
  import { BusinessError } from '@ohos.base';

  try {
    let relpath: string = 'etc/config.xml';
    let extra: string = 'etc/carrier/${telephony.sim.opkey0}';
    let result: string = configPolicy.getOneCfgFileSync(relpath, configPolicy.FollowXMode.USER_DEFINED, extra);
    console.log('result is ' + result);
  } catch (error) {
    let code = (error as BusinessError).code;
    let message = (error as BusinessError).message;
    console.log('error:' + code + ',' + message);
  }
  ```

## getCfgFiles<sup>11+</sup>

getCfgFiles(relPath: string, followMode: FollowXMode, callback: AsyncCallback&lt;Array&lt;string&gt;&gt;)

Obtains a list of configuration files based on the specified file name and follow mode, sorted in ascending order of priority. This API uses an asynchronous callback to return the result.
For example, there are three **config.xml** files (in ascending order of priority): **/system/etc/config.xml**, **/sys_pod/etc/config.xml**, and **/sys_pod/etc/carrier/46060/etc/config.xml**. If the opkey of the default card is **46060** and the follow mode is **SIM_DEFAULT**, **/system/etc/config.xml, /sys_pod/etc/config.xml, /sys_pod/etc/carrier/46060/etc/config.xml** is returned.

**System capability**: SystemCapability.Customization.ConfigPolicy

**Parameters**

| Name    | Type                                    | Mandatory| Description                      |
| ---------- | ---------------------------------------- | ---- | -------------------------- |
| relPath    | string                                   | Yes  | Name of the configuration file.                |
| followMode | [FollowXMode](#followxmode11)            | Yes  | Follow mode.                  |
| callback   | AsyncCallback&lt;Array&lt;string&gt;&gt; | Yes  | Callback used to return the file list.|

**Error codes**

For details about the error codes, see [Universal Error Codes](../errorcode-universal.md).

| ID| Error Message                                                                      |
| ------- | ---------------------------------------------------------------------------- |
| 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.|

**Example**

  ```ts
  import { BusinessError } from '@ohos.base';

  try {
    let relpath: string = 'etc/config.xml';
    configPolicy.getCfgFiles(relpath, configPolicy.FollowXMode.SIM_DEFAULT,
      (error: BusinessError, value: Array<string>) => {
      if (error == null) {
        console.log('value is ' + value);
      } else {
        console.log('error occurs ' + error);
      }
    });
  } catch (error) {
    let code = (error as BusinessError).code;
    let message = (error as BusinessError).message;
    console.log('error:' + code + ',' + message);
  }
  ```

## getCfgFiles<sup>11+</sup>

getCfgFiles(relPath: string, followMode: FollowXMode, extra: string, callback: AsyncCallback&lt;Array&lt;string&gt;&gt;)

Obtains a list of configuration files based on the specified file name and custom follow rule, sorted in ascending order of priority. This API uses an asynchronous callback to return the result.
For example, there are three **config.xml** files (in ascending order of priority): **/system/etc/config.xml**, **/sys_pod/etc/config.xml**, and **/sys_pod/etc/carrier/46060/etc/config.xml**. If the opkey of card 1 is **46060**, the follow mode is **USER_DEFINED**, and the custom follow rule is **etc/carrier/${telephony.sim.opkey0}**, **/system/etc/config.xml, /sys_pod/etc/config.xml, /sys_pod/etc/carrier/46060/etc/config.xml** is returned.

**System capability**: SystemCapability.Customization.ConfigPolicy

**Parameters**

| Name    | Type                                    | Mandatory| Description                                                  |
| ---------- | ---------------------------------------- | ---- | ------------------------------------------------------ |
| relPath    | string                                   | Yes  | Name of the configuration file.                                            |
| followMode | [FollowXMode](#followxmode11)            | Yes  | Follow mode.                                              |
| extra      | string                                   | Yes  | Custom follow rule. This parameter is valid only when **followMode** is set to **USER_DEFINED**.|
| callback   | AsyncCallback&lt;Array&lt;string&gt;&gt; | Yes  | Callback used to return the file list.                            |

**Error codes**

For details about the error codes, see [Universal Error Codes](../errorcode-universal.md).

| ID| Error Message                                                                      |
| ------- | ---------------------------------------------------------------------------- |
| 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.|

**Example**

  ```ts
  import { BusinessError } from '@ohos.base';

  try {
    let relpath: string = 'etc/config.xml';
    let extra: string = 'etc/carrier/${telephony.sim.opkey0}';
    configPolicy.getCfgFiles(relpath, configPolicy.FollowXMode.SIM_DEFAULT, extra,
      (error: BusinessError, value: Array<string>) => {
      if (error == null) {
        console.log('value is ' + value);
      } else {
        console.log('error occurs ' + error);
      }
    });
  } catch (error) {
    let code = (error as BusinessError).code;
    let message = (error as BusinessError).message;
    console.log('error:' + code + ',' + message);
  }
  ```

## getCfgFiles<sup>11+</sup>

getCfgFiles(relPath: string, followMode: FollowXMode, extra?: string): Promise&lt;Array&lt;string&gt;&gt;

Obtains a list of configuration files based on the specified file name and follow mode, sorted in ascending order of priority. This API uses a promise to return the result.

**System capability**: SystemCapability.Customization.ConfigPolicy

**Parameters**

| Name    | Type                         | Mandatory| Description                                                  |
| ---------- | ----------------------------- | ---- | ------------------------------------------------------ |
| relPath    | string                        | Yes  | Name of the configuration file.                                            |
| followMode | [FollowXMode](#followxmode11) | Yes  | Follow mode.                                              |
| extra      | string                        | No  | Custom follow rule. This parameter is valid only when **followMode** is set to **USER_DEFINED**.|

**Error codes**

For details about the error codes, see [Universal Error Codes](../errorcode-universal.md).

| ID| Error Message                                                                      |
| ------- | ---------------------------------------------------------------------------- |
| 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3.Parameter verification failed.|

**Return value**

| Type                              | Description    |
| ---------------------------------- | -------- |
| Promise&lt;Array&lt;string&gt;&gt; | Promise used to return the file list.|

**Example**

  ```ts
  import { BusinessError } from '@ohos.base';

  try {
    let relpath: string = 'etc/config.xml';
    let extra: string = 'etc/carrier/${telephony.sim.opkey0}';
    configPolicy.getCfgFiles(relpath, configPolicy.FollowXMode.SIM_DEFAULT, extra).then((value: Array<string>) => {
      console.log('value is ' + value);
    }).catch((error: BusinessError) => {
      console.log('getCfgFiles promise ' + error);
    });
  } catch (error) {
    let code = (error as BusinessError).code;
    let message = (error as BusinessError).message;
    console.log('error:' + code + ',' + message);
  }
  ```

## getCfgFilesSync<sup>11+</sup>

getCfgFilesSync(relPath: string, followMode?: FollowXMode, extra?: string): Array&lt;string&gt;

Obtains a list of configuration files based on the specified file name and follow mode, sorted in ascending order of priority. This API returns the result synchronously.

**System capability**: SystemCapability.Customization.ConfigPolicy

**Parameters**

| Name    | Type                         | Mandatory| Description                                                  |
| ---------- | ----------------------------- | ---- | ------------------------------------------------------ |
| relPath    | string                        | Yes  | Name of the configuration file.                                            |
| followMode | [FollowXMode](#followxmode11) | No  | Follow mode. The default value is **DEFAULT**.                   |
| extra      | string                        | No  | Custom follow rule. This parameter is valid only when **followMode** is set to **USER_DEFINED**.|

**Error codes**

For details about the error codes, see [Universal Error Codes](../errorcode-universal.md).

| ID| Error Message                                                                      |
| ------- | ---------------------------------------------------------------------------- |
| 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3.Parameter verification failed.|

**Return value**

| Type               | Description    |
| ------------------- | -------- |
| Array&lt;string&gt; | Promise used to return the file list.|


**Example**

  ```ts
  import { BusinessError } from '@ohos.base';

  try {
    let relpath: string = 'etc/config.xml';
    let extra: string = 'etc/carrier/${telephony.sim.opkey0}';
    let result: Array<string> = configPolicy.getCfgFilesSync(relpath, configPolicy.FollowXMode.USER_DEFINED, extra);
    console.log('result is ' + result);
  } catch (error) {
    let code = (error as BusinessError).code;
    let message = (error as BusinessError).message;
    console.log('error:' + code + ',' + message);
  }
  ```

## getCfgDirListSync<sup>11+</sup>

getCfgDirListSync(): Array&lt;string&gt;

Obtains the list of configuration level directories. This API returns the result synchronously.

**System capability**: SystemCapability.Customization.ConfigPolicy

**Return value**

| Type               | Description            |
| ------------------- | ---------------- |
| Array&lt;string&gt; | Promise used to return the configuration level directory list.|


**Example**

  ```ts
  import { BusinessError } from '@ohos.base';

  try {
    let result: Array<string> = configPolicy.getCfgDirListSync();
    console.log('result is ' + result);
  } catch (error) {
    let code = (error as BusinessError).code;
    let message = (error as BusinessError).message;
    console.log('error:' + code + ',' + message);
  }
  ```

## FollowXMode<sup>11+</sup>

**System capability**: SystemCapability.Customization.ConfigPolicy

| Name            | Value | Description                                                                                                                      |
| ---------------- | --- | -------------------------------------------------------------------------------------------------------------------------- |
| DEFAULT          | 0   | Files are searched based on the follow rules configured in the **followx_file_list.cfg** file at each configuration level.                               |
| NO_RULE_FOLLOWED | 1   | No follow rule is used, even if the **followx_file_list.cfg** file exists.                                             |
| SIM_DEFAULT      | 10  | Files are searched in **etc/carrier/${opkey}** file at each configuration level based on the opkey of the default card.                               |
| SIM_1            | 11  | Files are searched in **etc/carrier/${opkey}** at each configuration level based on the opkey of card 1.                                     |
| SIM_2            | 12  | Files are searched in **etc/carrier/${opkey}** at each configuration level based on the opkey of card 2.                                     |
| USER_DEFINED     | 100 | Files are searched based on the follow rule passed in **extra**, rather than the **followx_file_list.cfg** file at each configuration level.|