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