viki-web-utils

viki-web-utils

Web utilities used by the Viki web app

Installation

npm install -S viki-web-utils

---

Documentation

For full documentation, see it the docs page or in /docs directory.

ScrollTracker

Keeps track of the furthest point on page that user has scrolled to (in percentage). Returns most updated value everytime percentageSeen() is called.

Usage

import Viki from 'viki-web-utils';

const tracker = new Viki.ScrollTracker();
tracker.init();

console.log('percentage of page seen', tracker.percentageSeen()) // e.g. 5
console.log('percentage of page seen rounded to granularity of 10', tracker.percentageSeenRounded(10)) // e.g. 10

LocalStorageTabCounter

Keeps track of number of tabs user has open in current session. Saves current count to user's localStorage.

Usage

import Viki from 'viki-web-utils';

const counter = new Viki.LocalStorageTabCounter();

// open 2 tabs with current session

console.log(counter.getCount()) // 2

ResizeCounter

Tracks number of times user has resized the window. Debounced at 300ms to prevent too many function calls.

Usage

import Viki from 'viki-web-utils';

const counter = new Viki.ResizeCounter(function() {
  // do something, maybe fire an event
});

// resize browser window

console.log(counter.getCount()) // e.g. 1

BlockedResourceChecker

Tests if a resource is blocked on client side. Returns a Promise on test that is passed in blocked and resource values.

Usage

// create checker
const checker = new BlockedResourceChecker('https://badresource.blah');

// test resource returns a Promise
checker
  .test()
  .then((res) => {
    console.log(res.resource, res.blocked) // https://badresource.blah true 
  });

---

Development

Install dependencies

npm install

Run tests

npm run test

Karma wil prompt you to open browser on Google Chrome. To trigger tests, modify and save any src file.

Build and publishing

npm run build
npm run build-docs // generates JSDoc documentation to /docs dir
npm publish //script automatically builds before publish