bind-observable
v1.0.4
Published
This library provides the @BindObservable() decorator, which binds a property to a observable companion property.
Downloads
4,059
Readme
BindObservable decorator
This library provides the @BindObservable()
decorator, which binds a property to a observable companion property. The companion Observable always emits the latest value of the bound property.
Installation
npm install bind-observable --save
Usage
The following code binds the property myProp
to the observable property myProp$
and prints two values ('initialValue'
and 'newValue'
) to the console.
class MyClass {
@BindObservable()
public myProp: string = 'initialValue';
public myProp$!: Observable<string>;
}
const myInstance = new MyClass();
myInstance.myProp$.subscribe(console.log);
myInstance.myProp = 'newValue'
Details
This decorator adds property accessors to the PropertyDescriptor
of the decorated property. It will emit the getter value after every underlying setter call. You can use the emitRawSetterValue
option to emit the raw setter value and not a value, which is possibly modified by underlying setter and getter calls.
The decorator will also emit initial property values only if these values are explictly defined. In the following example the observable initializedProp$
does emit a undefined
value. On the other hand uninitializedProp$
will emit its first value on the first assignment.
class MyClass {
@BindObservable()
public uninitializedProp?: string;
public uninitializedProp$!: Observable<string>;
@BindObservable()
public initializedProp: string | undefined = undefined;
public initializedProp$!: Observable<string>;
}
const myInstance = new MyClass();
// Prints nothing to the console
myInstance.uninitializedProp$.subscribe(console.log);
// Prints 'undefined' to the console
myInstance.initializedProp$.subscribe(console.log);
Known Bugs
This decorator does not work if used directly on property accessors, but it can be used together with other decorators which add accessors to the PropertyDescriptor
.
class TestClass {
private _myProp: string | undefined;
public get myProp(): string | undefined {
return this._myProp
}
// This does not work :-(
@BindObservable()
public set myProp(value: string | undefined) {
this._myProp = value
}
private myProp$!: Observable<string | undefined>;
// This works even if DecoratorX and DecoratorY modify the property accessors
@DecoratorX()
@BindObservable()
@DecoratorY()
private myPropWithMultipleDecorators: string = 'initialValue';
private myPropWithMultipleDecorators$!: Observable<string>;
}