Selection

​Selection is a simple construct that operates on a nested property in the non-primitive Units' value, i.e.: ListUnit, GenericUnit, and DictUnit.
Selection offers the ability to access and observe a nested property at a certain path in a Unit's value.
Make a Selection
// create a Unit
const preferencesUnit = new DictUnit({initialValue: 
  {color: 'blue', music: 'EDM', game: 'GTA5'}
})
​
// make a selection
// the 'select' method takes path as it's params
const musicPreference = preferencesUnit.select('music')
Static Value Access
After creating a Selection object, we can access the value at the selected path anytime, without worrying if the value still exists or not.
// access the value at the selected path
console.log(musicPreference.value())
// logs 'EDM' immediately
Reactive Value Access
To observe the value over time we can make an Observable at the selected path, and subscribe to it.
// create an Observable
const musicPreference$ = musicPreference.asObservable()
​
// subsribe for reactive access
musicPreference$.subscribe(value => console.log(value))
// logs 'EDM' immediately, and
// will log whenever the value at the selected path changes
🔨 Utilities - Previous
Stream
Next - Integrations
Angular
Last updated 10 months ago