1# @ohos.application.Configuration (Configuration) 2 3The **Configuration** module defines environment change information. **Configuration** is an interface definition and is used only for field declaration. 4 5> **NOTE** 6> 7> The initial APIs of this module are supported since API version 8. Newly added APIs will be marked with a superscript to indicate their earliest API version. 8> This module is deprecated since API version 9. You are advised to use [@ohos.app.ability.Configuration](js-apis-app-ability-configuration.md) instead. 9 10## Modules to Import 11 12```ts 13import Configuration from '@ohos.application.Configuration'; 14``` 15 16## Properties 17 18**System capability**: SystemCapability.Ability.AbilityBase 19 20 | Name| Type| Readable| Writable| Description| 21| -------- | -------- | -------- | -------- | -------- | 22| language<sup>8+</sup> | string | Yes| Yes| Language of the application, for example, **zh**.| 23| colorMode<sup>8+</sup> | [ConfigurationConstant.ColorMode](js-apis-application-configurationConstant.md#colormode) | Yes| Yes| Color mode, which can be **COLOR_MODE_LIGHT** or **COLOR_MODE_DARK**. The default value is **COLOR_MODE_LIGHT**.| 24 25For details about the fields, see the **ohos.application.Configuration.d.ts** file. 26 27**Example** 28 ```ts 29import UIAbility from '@ohos.app.ability.UIAbility'; 30import AbilityConstant from '@ohos.app.ability.AbilityConstant'; 31import EnvironmentCallback from '@ohos.app.ability.EnvironmentCallback'; 32import Want from '@ohos.app.ability.Want'; 33import Window from '@ohos.window'; 34import { BusinessError } from '@ohos.base'; 35 36export default class EntryAbility extends UIAbility { 37 onCreate(want: Want, launchParam: AbilityConstant.LaunchParam) { 38 } 39 40 onDestroy() { 41 } 42 43 onWindowStageCreate(windowStage: Window.WindowStage) { 44 let envCallback: EnvironmentCallback = { 45 onConfigurationUpdated(config) { 46 console.info(`envCallback onConfigurationUpdated success: ${JSON.stringify(config)}`); 47 let language = config.language; 48 let colorMode = config.colorMode; 49 }, 50 onMemoryLevel(level){ 51 console.log(`onMemoryLevel level: ${JSON.stringify(level)}`); 52 } 53 }; 54 55 let applicationContext = this.context.getApplicationContext(); 56 try { 57 applicationContext.on('environment',envCallback); 58 } catch (paramError) { 59 console.error(`error: ${(paramError as BusinessError).code}, ${(paramError as BusinessError).message}`); 60 } 61 62 windowStage.loadContent('pages/index', (err, data) => { 63 if (err.code) { 64 console.error(`failed to load the content, error: ${JSON.stringify(err)}`); 65 return; 66 } 67 console.info(`Succeeded in loading the content, data: ${JSON.stringify(data)}`); 68 }); 69 } 70} 71 ``` 72