Interface ReadonlyVal<TValue>

A ReadonlyVal contains a readonly value and does not have a set method.

interface ReadonlyVal<TValue> {
    $version: any;
    get: (() => TValue);
    name?: string;
    value: TValue;
    $valCompute(subscriber): ValDisposer;
    dispose(): void;
    reaction(subscriber, eager?): ValDisposer;
    ref(): ReadonlyVal<TValue>;
    subscribe(subscriber, eager?): ValDisposer;
    unsubscribe(subscriber?): void;
}

Type Parameters

  • TValue = any

Hierarchy (view full)

Properties

$version get name? value

Methods

$valCompute dispose reaction ref subscribe unsubscribe

Properties

Readonly $version

$version: any

A version representation of the value. If two versions of a val is not equal(Object.is), it means the value has changed (event if the value is equal).

get

get: (() => TValue)

Get current value of the val.

Type declaration

Optional Readonly name

name?: string

Display debug name.

Readonly value

value: TValue

Current value of the val.

Methods

$valCompute

  • $valCompute(subscriber): ValDisposer

  • Subscribe to value changes without immediate emission. The subscribers will be called before sync and async subscribers from [[reaction]] and [[subscribe]]. It is mainly used for chaining Vals.

    Parameters

    Returns ValDisposer

    a disposer function that cancels the subscription

dispose

reaction

  • reaction(subscriber, eager?): ValDisposer

  • Subscribe to value changes without immediate emission.

    Parameters

    • subscriber: ValSubscriber<TValue>
    • Optional eager: boolean

      by default subscribers will be notified on next tick. set true to notify subscribers of value changes synchronously.

    Returns ValDisposer

    a disposer function that cancels the subscription

ref

  • ref(): ReadonlyVal<TValue>

  • Create a new ReadonlyVal referencing the value of the current ReadonlyVal as source. (It is just like derive a val without transform. It is simpler hence more efficient.) All ref ReadonlyVals share the same value from the source ReadonlyVal.

    With this pattern you can pass a ref ReadonlyVal to downstream. The ref ReadonlyVals can be safely disposed without affecting the source ReadonlyVal and other ref ReadonlyVals.

    Returns ReadonlyVal<TValue>

subscribe

  • subscribe(subscriber, eager?): ValDisposer

  • Subscribe to value changes with immediate emission.

    Parameters

    • subscriber: ValSubscriber<TValue>
    • Optional eager: boolean

      by default subscribers will be notified on next tick. set true to notify subscribers of value changes synchronously.

    Returns ValDisposer

    a disposer function that cancels the subscription

unsubscribe

  • unsubscribe(subscriber?): void

  • Remove the given subscriber. Remove all if no subscriber provided.

    Parameters

    • Optional subscriber: ((...args) => any)
        • (...args): any

        • Parameters

          • Rest ...args: any[]

          Returns any

    Returns void

Settings

Theme

On This Page

$versiongetnamevalue$valComputedisposereactionrefsubscribeunsubscribe