Class: MappedUserSettingManager<T, O>
Defined in: src/sdk/settings/UserSetting.ts:338
A manager for user settings. Provides settings using their names as keys, publishes value change events on the event bus, and keeps setting values up to date when receiving change events across the bus, using a mapping from abstracted settings keys to true underlying settings keys.
Type Parameters
Type Parameter |
---|
T extends UserSettingRecord |
O extends UserSettingRecord |
Implements
UserSettingManager
<T
&O
>
Constructors
Constructor
new MappedUserSettingManager<
T
,O
>(parent
,map
):MappedUserSettingManager
<T
,O
>
Defined in: src/sdk/settings/UserSetting.ts:345
Creates an instance of a MappedUserSettingManager.
Parameters
Parameter | Type | Description |
---|---|---|
parent | UserSettingManager <O > | The parent setting manager. |
map | UserSettingMap <T , O > | The map of abstracted keys to true underlying keys. |
Returns
MappedUserSettingManager
<T
, O
>
Methods
getAllSettings()
getAllSettings():
UserSetting
<UserSettingValue
>[]
Defined in: src/sdk/settings/UserSetting.ts:366
Gets an array of all settings of this manager.
Returns
UserSetting
<UserSettingValue
>[]
an array of all settings of this manager.
Implementation of
UserSettingManager
.getAllSettings
getSetting()
getSetting<
K
>(name
):UserSetting
<NonNullable
<T
&O
[K
]>>
Defined in: src/sdk/settings/UserSetting.ts:354
Gets a setting from this manager.
Type Parameters
Type Parameter |
---|
K extends string |
Parameters
Parameter | Type | Description |
---|---|---|
name | K | The name of the setting to get. |
Returns
UserSetting
<NonNullable
<T
& O
[K
]>>
The requested setting.
Throws
Error if no setting with the specified name exists.
Implementation of
mapTo()
mapTo<
M
>(map
):MappedUserSettingManager
<M
,T
&O
>
Defined in: src/sdk/settings/UserSetting.ts:371
Maps a subset of this manager's settings to ones with aliased names, and creates a new setting manager which supports accessing the settings using their aliases.
Type Parameters
Type Parameter |
---|
M extends UserSettingRecord |
Parameters
Parameter | Type | Description |
---|---|---|
map | UserSettingMap <M , T & O > | A map defining the aliases of a subset of this manager's settings, with aliased setting names as keys and original setting names as values. |
Returns
MappedUserSettingManager
<M
, T
& O
>
A new setting manager which supports accessing a subset of this manager's settings using aliased names.
Implementation of
tryGetSetting()
tryGetSetting<
K
>(name
):undefined
|UserSetting
<NonNullable
<T
&O
[K
]>>
Defined in: src/sdk/settings/UserSetting.ts:348
Attempts to get a setting from this manager.
Type Parameters
Type Parameter |
---|
K extends string |
Parameters
Parameter | Type | Description |
---|---|---|
name | K | The name of the setting to get. |
Returns
undefined
| UserSetting
<NonNullable
<T
& O
[K
]>>
The requested setting, or undefined
if no such setting exists.
Implementation of
UserSettingManager
.tryGetSetting
whenSettingChanged()
whenSettingChanged<
K
>(name
):Consumer
<NonNullable
<T
&O
[K
]>>
Defined in: src/sdk/settings/UserSetting.ts:360
Gets a consumer which notifies handlers when the value of a setting changes.
Type Parameters
Type Parameter |
---|
K extends string |
Parameters
Parameter | Type | Description |
---|---|---|
name | K | The name of a setting. |
Returns
Consumer
<NonNullable
<T
& O
[K
]>>
a consumer which notifies handlers when the value of the setting changes.
Throws
Error if no setting with the specified name exists.