npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

avo-js

v1.0.3

Published

A JS framework that listens for variable changes and runs callbacks on them.

Downloads

2

Readme

Welcome to AvoJS

AvoJS is a simple, un-opinionated, and lightweight library for adding callbacks to function changes. Weighing in at under 400 bytes, it's easily small enough to use without worry.

Installation

You can include AvoJS in your web application with the following script tag:

<script type="text/javascript" src="https://cdn.jsdelivr.net/gh/benjaminbhollon/avo-js@1/avo.min.js"></script>

Really, though, AvoJS is so lightweight (Under 400 bytes!) that you should be able to host it yourself with zero problems. Just download avo.min.js from the repository and include it in a script tag. Honestly, it's so small that you could put it in an inline script tag if you like.

If you're using NodeJS, you can install AvoJS via NPM:

$ npm install avo-js

Then include it in your application:

const avo = require('avo-js');

Potential use cases

  • Automatically updating an HTML element's content when a variable's value changes (see example below).
  • Updating the page whenever new information becomes available (for example, if you request information from an API and set the variable in a callback, it can automatically update the page)
  • Validating input as soon as it happens
  • Best of all, being able to combine multiple implementations. The same function could be called, for example, on user input, AJAX callback, and everywhere else that a variable's value is changed.

This is a non-comprehensive list. It was just me thinking up a few possibilities right after finishing the first version. Please do let me know your implementation so I can add it! I look forward to hearing about this being used in ways I never foresaw.

Usage

AvoJS has a special syntax for variables, but it's not too hard to get the hang of. It goes like this:

avo(varName);

Note that there is no need to declare AvoJS variables (and it may even cause problems if you do). Just start using them and it will work smoothly.

To set/get the value of your AvoJS variable, use avo(varName).value. If you forget to use the value property, it will throw an error. avo(varName).value can be treated pretty much like a normal JS variable and function properly.

Now, if you don't add a callback, there's no reason to use AvoJS. So here's how you bind a callback to a AvoJS variable:

avo(varName).bind(callback);

That's it. From now on whenever you assign the value of avo(varName).value, the callback function will run.

Please note that the callback will only run for assignments after it has been bound to the variable. On the plus side, this means that you can change the callback at a later point in execution. Just run avo(varName).bind(callback) with your new callback.

Example

In this example, we will use AvoJS to automatically update the header of a document (with the id documentHeader) with the value of a text input (with the id documentHeaderInput).

Here is the HTML:

<h1 id="documentHeader">Untitled</h1>
<input type="text" value="Untitled" id="documentHeaderInput">

<!--Include avo.min.js-->
<script type="text/javascript" src="https://cdn.jsdelivr.net/gh/benjaminbhollon/avo-js@1/avo.min.js"></script>
<!--Include the JS we'll be writing below-->
<script type="text/javascript" src="script.js"></script>

Pretty simple. Now here's the JS:

avo('documentTitle').value = "Untitled"; // Sets to Untitled -- Note that this will not update the header because we have not yet bound the callback. You can bind the callback before assigning the variable's value as well, which _would_ update the header.

//When the document title changes, update the page header
avo('documentTitle').bind(() => {
  document.getElementById("documentTitle").innerText = avo('documentTitle');.value;
});

//Listen for user changes the title to the text input
document.getElementById('documentTitleInput').addEventListener('input', () => {
  avo('documentTitle').value = this.value; // This will automatically trigger the callback and update the header to match
});

Pretty easy. But I believe that coding's beauty is in its ability to simplify complex problems into small chunks. This 400-byte library (!!!) is powerful enough to be useful in endless use-cases. I originally wrote it for use in a social media app that I'm coding and for a messaging app my friend is making.


A See With Eyes Closed Project by Benjamin Hollon. If you enjoyed this, stop by my site and take a look at some of the other stuff I've made.