force storage document about basil.js

[johnhaldson]

Isn't the defaultStorage set on init if passed in the options and then used by default?

https://github.com/Wisembly/basil.js/blob/master/src/basil.js#L189

[bitinn]

yes, but if you try to overwrite the default with example query, i don't think you will get the desired result.

var storages = _toStoragesArray(options.storages) || [this.defaultStorage];

set does not use options.storage, only options.storages; and the way options.storages are used seem undesirable.

[guillaumepotier]

Indeed, we deprecated options.storage and implemented instead options.storages to allow storing on the go on one or more storages at the time.

If you want to persist on cookie instead of default local, just use

basil.set('foo', 'bar', { 'storages': ['cookie'] });

If you want to persist both in cookie and localstorage, use then

basil.set('foo', 'bar', { 'storages': ['local', 'cookie'] });

We changed a bit the API because we faced in our project the need to store something in localstorage which is fast for our app, but needed to persist it too in cookie for later usage.

I don't really see why the ability to set and remove on all available storage is an undesirable feature?

[guillaumepotier]

Hi there,

We are nearly ready to roll out #26 0.4.0 version, that changed the actual behavior. Basil won't allow anymore to persist in simultaneous storages, but will choose the 1rst available storage in list if given in storages options

// try first to store it into cookies and if not possible into localStorage
basil.set('foo', 'quux', { 'storages': ['cookie', 'local'] });

It would still be possible to directly store in a specific storage using Basil.localStorage.set() API.

Best