miansaleem / vue-forage

A Vue plugin for localForage

vue-forage

A Vue.js wrapper plugin for localForage

Installation

Simply install the npm package vue-forage:

NPM

npm i vue-forage

YARN

yarn add vue-forage

Using vue-forage

In your main JavaScript file (eg. main.js or app.js):

// Import Vue and vue-forage
import Vue from 'vue';
import vf from 'vue-forage';

// Tell Vue.js to use vue-forage
Vue.use(vf);

In your app/components:

// configure your local storage
this.$vf.config({
    name: 'vue-forage'
});

// change driver
// this.$vf.useWebSQLDriver();
// this.$vf.useIndexedDBDriver();
this.$vf.useLocalStorageDriver();
// this.$vf.setDriver(YOURDRIVER);

// SET ITEM
// this.$vf.setItem('key', 'value');
this.$vf.setItem('app', 'Vue Forage');

// or
this.$vf.setItem('app', { app: 'Vue Forage', version: '1.0.0', author: { name: 'John Doe', email: '[email protected]' }});

// GET ITEM
// this.$vf.getItem('key'');

this.$vf.getItem('app');

// REMOVE ITEM
// this.$vf.removeItem('key'');

this.$vf.removeItem('app');

this.$vf.clear(); // delete everything

// Forage will stringify/parse the json object automatically.

---

All the methods will return promise. Use .then() and .catch() whereever you need.

• Please refer to localForage documentation for more info, you can view the localForage Docs at https://localforage.github.io/localForage

---

Default Driver

By default, localForage selects backend drivers for the datastore in this order:

1. IndexedDB localforage.INDEXEDDB
2. WebSQL localforage.WEBSQL
3. localStorage localforage.LOCALSTORAGE

If you would like to force usage of a particular driver you can this.$vf.useLocalStorageDriver(); or this.$vf.useIndexedDBDriver(); or this.$vf.useWebSQLDriver(); or for custom drivers this.$vf.setDriver(yourdriver);

this.$vf.createInstance({
    storeName: 'user' // name of the datastore for IndexedDB & WebSQL - must be alphanumeric, with underscores
}).then((store) => {
    store.setItem('key', ['some', 'value']);
    store.length().then((keys) => {
        console.log(keys);
    });
    store.iterate((value, key, num) => {
        return [key, value];
    }).then((result) => {
        console.log(result);
    });
});

API will work same as localForage in your vue app with this.$vf, only the json has been added to update json objects easily.

You can use . notation for json object, if you need to update the version in above app code then you can simple

this.$vf.json('app.version', '1.0.1');

and to update author name

this.$vf.json('app.author.name', 'Mian Saleem');

json will resolve with main object, in above example code .then(value => console.log(value)) will log the updated app object.

Contributing

Any sort of contributions and feedback is much appreciated. Just leave an issue or pull-request!