xref: /docs/zh-cn/application-dev/reference/common/js-apis-syscap.md (revision e41f4b71)

# SysCap (系统能力)

系统能力（SystemCapability，简称SysCap），指操作系统中每一个相对独立的特性。不同的设备对应不同的系统能力集，每个系统能力对应一个或多个API。开发者可根据系统能力来判断是否可以使用某接口。

> **说明：**
>
> 本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。

## canIUse

canIUse(syscap: string): boolean

查询系统是否具备某个系统能力。

**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。

**系统能力：** SystemCapability.ArkUI.ArkUI.Full

**参数：**

| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------- | -------- | -------- |
| syscap | string | 是 | 待查询的系统能力名称。 |

**返回值：**

| 类型 | 说明 |
| -------- | -------- |
| boolean | 系统能力查询结果，true表示系统具备该能力，false表示系统不具备。 |

**示例：**

  ```js
import { geoLocationManager } from '@kit.LocationKit'
import { BusinessError } from '@kit.BasicServicesKit';

const isLocationAvailable = canIUse('SystemCapability.Location.Location.Core');
if (isLocationAvailable) {
    geoLocationManager.getCurrentLocation((err: BusinessError, location: geoLocationManager.Location) => {
        if (err) {
            console.error('err=' + JSON.stringify(err));
        }
        if (location) {
            console.log('location=' + JSON.stringify(location));
        }
    });
} else {
    console.log('Location not by this device.');
}
  ```