1# ConnectOptions 2 3在连接指定的后台服务时作为入参，用于接收连接过程中的状态变化，如作为[connectServiceExtensionAbility](js-apis-inner-application-uiAbilityContext.md#uiabilitycontextconnectserviceextensionability)的入参，连接指定的ServiceExtensionAbility。 4 5> **说明：** 6> 7> 本模块首批接口从API version 7开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 8 9## 导入模块 10 11```ts 12import common from '@ohos.app.ability.common'; 13``` 14 15## 属性 16 17**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core 18 19| 名称 | 类型 | 必填 | 说明 | 20| ------------ | -------- | ---- | ------------------------- | 21| onConnect<sup>7+</sup> | function | 是 | 建立连接时的回调函数。 | 22| onDisconnect<sup>7+</sup> | function | 是 | 断开连接时的回调函数。 | 23| onFailed<sup>7+</sup> | function | 是 | 连接失败时的回调函数。 | 24 25**示例：** 26 27 ```ts 28 import common from '@ohos.app.ability.common'; 29 import Want from '@ohos.app.ability.Want'; 30 31 let want: Want = { 32 bundleName: 'com.example.myapp', 33 abilityName: 'MyAbility' 34 }; 35 36 let connectOptions: common.ConnectOptions = { 37 onConnect(elementName, remote) { 38 console.log('onConnect elementName: ${elementName}'); 39 }, 40 onDisconnect(elementName) { 41 console.log('onDisconnect elementName: ${elementName}'); 42 }, 43 onFailed(code) { 44 console.error('onFailed code: ${code}'); 45 } 46 }; 47 48 let connection: number = this.context.connectAbility(want, connectOptions); 49 ```