amazing header photo by Zach Kadolph
Hi! ๐ In the previous post, I've introduced you to rxjs-proxify
that turns your Observable into an Object of Observables:
const o = of({ msg: 'Hello' }, { msg: 'World' });
const p = proxify(o);
p.msg.subscribe(console.log); // > Hello > World
Today I'll show you what new abilities you get with the recent 0.0.10
release: now proxify
can be applied not only on Observables but also on Subjects and BehaviorSubjects. Also, we get a statify
method that will help you manage the local state!
tl;dr try & install: github.com/kosich/rxjs-proxify
๐ Intro
Observable Proxy (already familiar to you)
subscribe at any depth
const observable = proxify( of({ p: '๐' }) );
observable.subscribe(console.log); // > { p: ๐ }
observable.p.subscribe(console.log); // > ๐
It will be handy if you need to access many sub-properties on your streams:
// framework agnostic model
const { title, body } = proxify( fetchArticle() );
// framework agnostic view
<article>
<Title value={ title } />
<Body value={ body } />
</article>
Note that here we're creating two separate Observables, so you'll probably want to .pipe( share() )
inside fetchArticle
.
Subject Proxy
subscribe at any depth, push at the root
const subject = proxify(new Subject<{ p: string }>());
subject.subscribe(console.log);
subject.p.subscribe(console.log);
subject.next({ p: '๐ฅ' }); // > { p: ๐ฅ } // > ๐ฅ
While you have all the benefits of Observable Proxy, you can also update the whole Subject value.
BehaviorSubject Proxy
subscribe at any depth, push at any depth, synchronously read the current state
const behavior = proxify(new BehaviorSubject({ p: '๐' }));
behavior.p.subscribe(console.log); // > ๐
behavior.p.next('๐'); // > ๐
console.log(behavior.p.value) // > ๐
In addition to Observable Proxy, you can synchronously read and update the state at any level!
// model
const s = proxify(
new BehaviorSubject({ title: '', checked: false })
);
// view
<div>
<input
value={ s.title }
onChange={ e => s.title.next(e.target.value) } />
<input
type="checkbox"
checked={ s.checked }
onChange={ e => s.checked.next(e.target.checked) } />
</div>
State proxy
And we also export a statify
function that creates a BehaviorSubject Proxy with a distinctUntilChanged
on all its properties:
// create a state
const state = statify({ a: '๐ฐ', z: '๐ก' });
// listen to & log root state changes
state.subscribe(console.log); //> { a:๐ฐ z:๐ก }
// update particular substate
state.a.next('๐'); //> { a:๐ z:๐ก }
state.a.next('๐'); //> same value, no update
// read current values
console.log(state.z.value + state.a.value); //> ๐ก๐
// update root state, still logging
state.next({ a: '๐', z: 'โ๏ธ' }) //> { a:๐ z:โ๏ธ }
// and thenโฆ
state.z.next('๐'); //> { a:๐ z:๐ }
state.a.next('๐๐'); //> { a:๐๐ z:๐ }
state.z.next('๐ธ') //> { a:๐๐ z:๐ธ }
state.a.next('๐จ'); //> { a:๐จ z:๐ธ }
That's it! Just a few words before you go:
๐ Outro
You can try proxify
online.
And you'll find more examples and the installation guide at github.com/kosich/rxjs-proxify. Hope you'll find these little tools useful!
If you enjoyed reading โ please, indicate that with โค๏ธ ๐ฆ ๐ buttons
Follow me here and on twitter for more RxJS, React, and JS posts!
Thank you for reading this article! Stay reactive and have a nice day ๐
And thanks to @fkrasnowski for discussing with me and polishing this idea in the previous post comments!