• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# ExtensionContext
2<!--Kit: Ability Kit-->
3<!--Subsystem: Ability-->
4<!--Owner: @yewei0794-->
5<!--Designer: @jsjzju-->
6<!--Tester: @lixueqing513-->
7<!--Adviser: @huipeizi-->
8
9ExtensionContext是[ExtensionAbility](js-apis-app-ability-extensionAbility.md)的上下文环境,继承自[Context](js-apis-inner-application-context.md#context)。
10
11ExtensionContext模块提供访问特定[ExtensionAbility](js-apis-app-ability-extensionAbility.md)的资源的能力,对于扩展的ExtensionAbility,可直接将ExtensionContext作为上下文环境,或者定义一个继承自ExtensionContext的类型作为上下文环境。
12
13> **说明:**
14>
15>  - 本模块首批接口从API version 9开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
16>  - 本模块接口仅可在Stage模型下使用。
17
18## 导入模块
19
20```ts
21import { common } from '@kit.AbilityKit';
22```
23
24## 属性
25
26**原子化服务API**:从API version 11开始,该接口支持在原子化服务中使用。
27
28**系统能力**:SystemCapability.Ability.AbilityRuntime.Core
29
30| 名称 | 类型 | 只读 | 可选 | 说明 |
31| -------- | -------- | -------- | -------- | -------- |
32| currentHapModuleInfo | [HapModuleInfo](js-apis-bundleManager-hapModuleInfo.md) | 否 | 否 | 所属Hap包的信息。 |
33| config   | [Configuration](js-apis-app-ability-configuration.md) | 否 | 否 | 所属Module的配置信息。 |
34| extensionAbilityInfo | [ExtensionAbilityInfo](js-apis-bundleManager-extensionAbilityInfo.md) | 否 | 否 | 所属[ExtensionAbility](js-apis-app-ability-extensionAbility.md)的信息。 |
35
36## 使用场景
37ExtensionContext主要用于查询所属ExtensionAbility的信息、Module的配置信息以及HAP包的信息,开发者可根据自身业务需求使用对应的信息。
38
39**示例:**
40
41在扩展的[FormExtensionAbility](../apis-form-kit/js-apis-app-form-formExtensionAbility.md)中获取上下文,查询该扩展的FormExtensionAbility所属HAP包等信息。
42
43```ts
44import { FormExtensionAbility, formBindingData } from '@kit.FormKit';
45import { Want } from '@kit.AbilityKit';
46
47export default class MyFormExtensionAbility extends FormExtensionAbility {
48  onAddForm(want: Want) {
49    console.info(`FormExtensionAbility onAddForm, want: ${want.abilityName}`);
50    let extensionContext = this.context;
51    let hapInfo = extensionContext.currentHapModuleInfo;
52    console.info(`HAP name is: ${hapInfo.name}`);
53    let dataObj1: Record<string, string> = {
54      'temperature': '11c',
55      'time': '11:00'
56    };
57    let obj1: formBindingData.FormBindingData = formBindingData.createFormBindingData(dataObj1);
58    return obj1;
59  }
60};
61```
62