@ohos.systemCapability (System Capability) (System API)

System capability (SysCap) refers to a relatively independent feature in the operating system. Different devices provide different system capabilities, and multiple APIs implement a system capability. You can determine whether an API can be used based on system capabilities. This module provides APIs for querying the set of system capabilities.

NOTE

• The initial APIs of this module are supported since API version 9. 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

import { systemCapability } from '@kit.BasicServicesKit';

systemCapability.querySystemCapabilities

querySystemCapabilities(callback: AsyncCallback<string>): void

Queries the system capabilities. This API uses an asynchronous callback to return the result.

System capability: SystemCapability.Developtools.Syscap

Parameters

Name	Type	Mandatory	Description
callback	AsyncCallback<string>	Yes	Callback used to return the result.

Example

try {
    systemCapability.querySystemCapabilities((err:Error, data:string) => {
    if (err == undefined) {
        console.info("get system capabilities:" + data);
    } else {
        console.error(" get system capabilities err:" + err);
    }});
}catch(e){
    console.error("get unexpected error: " + e);
}

systemCapability.querySystemCapabilities

querySystemCapabilities(): Promise<string>

Queries the system capabilities. This API uses a promise to return the result.

System capability: SystemCapability.Developtools.Syscap

Return value

Type	Description
Promise<string>	Promise used to return the result.

Example

try {
    systemCapability.querySystemCapabilities().then((value:string) => {
        console.info("get system capabilities: " + value);
    }).catch((err:Error) => {
        console.error("get system capabilities error: " + err);
    });
}catch(e){
    console.error("get unexpected error: " + e);
}

NOTE

The system capabilities returned by the preceding APIs are in the form of an encoded numeric string.