Skip to main content

alt text

Observe

Simply observe any variable in Deno

Test module
nest badge

Example (Deno)

let obs = new Observe("initial value"); // new observable with type String

obs.bind((data) => { // bind to receive updates on value change
    // Do some stuff here (data here is of type string)
});

obs.setValue("another value"); // sets the value
obs.setValue("lorem", "ipsum", "dolor"); // sets the last value as active and emitting the other ones
console.log(obs.setValue("another value"))

Also check the examples folder for more examples

Example (Basic html + js)

Download Observe.js from the releases tab

index.html

<html>
    <head></head>
    <body>
        <h1>Observable value test</h1>
        <script type="module" src="Observe.bundle.js"></script> <!-- Needs to come from a server as type module does not support local files-->
        <script src="./index.js"></script>
    </body>
</html>

index.js

var observable = new Observe("s")
observable.bind((d)=>{
    console.log(d)
})
observable.setValue("new val")

Methods

| Name | Description | |—————- |—————————————————————————————————————————————————————————————————————————– | | getValue() | Returns the current value. To be used outside of callbacks | | getHistory() | Gets the change history. Every time a new value is set it is pushed to a history array | | bind() | used to listen to changes. Takes a callback method that is called with the new data when the observe instance changes. Returns the function used for the event listener.. To be used with the unBind method (see below) | | unBind() | Unbinds a previously bound EventListener or EventListenerObject. The callback returned by bind() should be provided. Returns this | | setValue() | Updates the observed value.. all bound will be notified. Setting a value equals to the last set value will do nothing. Returns the value that was passed in it (last value in case multiple) | | stop() | Prevents event from reaching any registered event listeners after the current one. Returns this | | reset() | Restore the state to the original provided method. Returns this | | maxHistorySize | Limit the history array size (can be lowered to save some precious ram) |

The history length is limited to 1000 values.. after this the first value (excluding the original) will be removed on each push.. to increase or decrease this value change the “maxHistorySize” variable

See JSdoc for more information

Testing

deno test