1# getContext
2
3如果需要在页面中获得当前Ability的Context,可调用getContext接口获取当前页面关联的UIAbilityContext或ExtensionContext。
4
5> **说明:**
6> - 该接口从API version 9开始支持。
7> - 该接口仅限Stage模型使用。
8
9getContext(component?: Object):Context
10
11获取与页面上下文组件关联的Context对象。
12
13**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。
14
15**系统能力:** SystemCapability.ArkUI.ArkUI.Full
16
17**参数:**
18
19| 参数名 | 类型          | 必填 | 说明                             |
20| ------ | ----------- | ---- | ------------------------------- |
21| component  | Object | 否   | 当前自定义组件的实例。未传入component或传入的参数类型非法,则返回默认上下文。默认上下文是指通过追溯当前方法的调用链所跟踪到的Context。在异步调用的回调方法中使用该接口,或者该接口的起始调用不在当前页面,将可能导致无法跟踪到该实例的Context,则会返回undefined。             |
22
23**返回值:**
24
25| 类型 | 说明                             |
26| ------ | ------------------------------- |
27| [Context](../../application-models/application-context-stage.md#应用上下文context)  | 返回当前组件所在Ability的Context,Context的具体类型为当前Ability关联的Context对象。例如:在UIAbility窗口中的页面调用该接口,返回类型为UIAbilityContext。在ExtensionAbility窗口中的页面调用该接口,返回类型为ExtensionContext。    |
28
29**示例:**
30
31在UIAbility中通过windowStage.loadContent加载具体页面。
32
33> **说明:**
34>
35> 直接使用getContext可能导致实例不明确的问题,建议使用[getUIContext](js-apis-arkui-UIContext.md#uicontext)获取UIContext实例,并使用[getHostContext](js-apis-arkui-UIContext.md#gethostcontext12)调用绑定实例的getContext。
36
37```ts
38// EntryAbility.ets
39import { UIAbility, AbilityConstant, Want } from '@kit.AbilityKit';
40import { hilog } from '@kit.PerformanceAnalysisKit';
41import { window } from '@kit.ArkUI';
42
43export default class EntryAbility extends UIAbility {
44  onCreate(want: Want, launchParam: AbilityConstant.LaunchParam) {
45    hilog.info(0x0000, 'testTag', '%{public}s', 'Ability onCreate');
46  }
47
48  onDestroy() {
49    hilog.info(0x0000, 'testTag', '%{public}s', 'Ability onDestroy');
50  }
51
52  onWindowStageCreate(windowStage: window.WindowStage) {
53    hilog.info(0x0000, 'testTag', '%{public}s', 'Ability onWindowStageCreate');
54
55    windowStage.loadContent('pages/Index', (err, data) => {
56      if (err.code) {
57        hilog.error(0x0000, 'testTag', 'Failed to load the content. Cause: %{public}s', JSON.stringify(err) ?? '');
58        return;
59      }
60      hilog.info(0x0000, 'testTag', 'Succeeded in loading the content. Data: %{public}s', JSON.stringify(data) ?? '');
61    });
62  }
63
64  onWindowStageDestroy() {
65    hilog.info(0x0000, 'testTag', '%{public}s', 'Ability onWindowStageDestroy');
66  }
67
68  onForeground() {
69    hilog.info(0x0000, 'testTag', '%{public}s', 'Ability onForeground');
70  }
71
72  onBackground() {
73    hilog.info(0x0000, 'testTag', '%{public}s', 'Ability onBackground');
74  }
75}
76```
77在具体的Index.ets中可以通过getContext接口获取Context上下文,本示例返回的Context类型为UIAbilityContext。
78
79```ts
80//pages/Index.ets
81@Entry
82@Component
83struct Index {
84  @State message: string = 'Hello World'
85
86  build() {
87    Row() {
88      Column() {
89        Text(this.message)
90          .fontSize(50)
91          .fontWeight(FontWeight.Bold)
92          .onClick(() => {
93            // 建议使用this.getUIContext().getHostContext()
94            let context : Context = getContext(this) as Context
95            console.info("CacheDir:" + context.cacheDir)
96          })
97      }
98      .width('100%')
99    }
100    .height('100%')
101  }
102}
103```
104