WindowExtensionContext

WindowExtensionContext模块是WindowExtensionAbility的上下文环境，继承自ExtensionContext。

WindowExtensionContext模块提供WindowExtensionAbility具有的能力，包括启动Ability。

说明：

• 本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。

• 本模块接口为系统接口。

• 本模块接口仅可在Stage模型下使用。

使用说明

在使用WindowExtensionContext的功能前，需要通过WindowExtensionAbility子类实例获取。

  import WindowExtensionAbility from '@ohos.application.WindowExtensionAbility';

  let context;
  class WindowExtAbility extends WindowExtensionAbility {
    onConnect() {
      context = this.context; // 获取WindowExtensionContext
    }
  }

WindowExtensionContext.startAbility

startAbility(want: Want, options: StartOptions, callback: AsyncCallback<void>): void

启动Ability，使用callback异步回调。

系统能力：SystemCapability.WindowManager.WindowManager.Core

参数：

参数名	类型	必填	说明
want	Want	是	启动Ability的want信息。
options	StartOptions	是	启动Ability所携带的参数。
callback	AsyncCallback<void>	是	callback形式返回启动结果。

示例：

var want = {
  bundleName: 'com.example.myapplication',
  abilityName: 'MainAbility'
};
var options = {
  windowMode: 102
};

try {
  this.context.startAbility(want, options, (error) => {
    if (error.code) {
      // 处理业务逻辑错误
      console.error('startAbility failed, error.code: ${error.code}, error.message: ${error.message}');
      return;
    }
    // 执行正常业务
    console.log('startAbility succeed');
  });
} catch (paramError) {
  // 处理入参错误异常
  console.error('error.code: ${paramError.code}, error.message: ${paramError.message}');
}

WindowExtensionContext.startAbility

startAbility(want: Want, options?: StartOptions): Promise<void>

启动Ability，使用Promise异步回调。

系统能力：SystemCapability.WindowManager.WindowManager.Core

参数：

参数名	类型	必填	说明
want	Want	是	Want类型参数，传入需要启动的ability的信息，如Ability名称，Bundle名称等。
options	StartOptions	否	启动Ability所携带的参数。

返回值：

类型	说明
Promise<void>	无返回结果的Promise对象。

示例：

var want = {
  bundleName: 'com.example.myapp',
  abilityName: 'MainAbility'
};
var options = {
	windowMode: 102,
};

try {
  this.context.startAbility(want, options)
    .then((data) => {
      // 执行正常业务
      console.log('startAbility succeed');
    })
    .catch((error) => {
      // 处理业务逻辑错误
      console.error('startAbility failed, error.code: ${error.code}, error.message: ${error.message}');
    });
} catch (paramError) {
  // 处理入参错误异常
  console.error('error.code: ${paramError.code}, error.message: ${paramError.message}');
}