Skip to content

Latest commit

 

History

History
105 lines (75 loc) · 2.32 KB

README.md

File metadata and controls

105 lines (75 loc) · 2.32 KB

SyncStorage

Synchronous storage for React Native AsyncStorage.

Build Status codecov npm version license

Get Started

Installation

yarn add sync-storage
# or
# npm i --save sync-storage

Usage

import SyncStorage from 'sync-storage';

SyncStorage.set('foo', 'bar');

const result = SyncStorage.get('foo');
console.log(result); // 'bar'

Methods Available

init()

Init prepares the SyncStorage to work synchronously, by getting all values for all keys previously saved on RN AsyncStorage. See the example:

const data = await SyncStorage.init();
console.log('AsyncStorage is ready!', data);

get(key: string)

Returns the value of key.

SyncStorage.get('foo'); // 'bar'

set(key: string, value: Any type)

It saves the value on memory and on the AsyncStorage.

SyncStorage.set('foo', 'bar');
SyncStorage.get('foo'); // 'bar'

It also returns a Promise for post verification.

SyncStorage.set('foo', 'bar')
  .then(() => {
    SyncStorage.get('foo'); // 'bar'
  })
  .catch(error => {
    console.log(error);
  });

remove(key: string)

It removes the value from the memory and from the AsyncStorage.

SyncStorage.remove('foo');

It also returns a Promise for post verification.

SyncStorage.remove('foo')
  .then(() => {
    SyncStorage.get('foo'); // undefined
  })
  .catch(error => {
    console.log(error);
  });

getAllKeys()

returns an array from all the keys.

SyncStorage.set('foo', 'bar');
SyncStorage.set('boo', 'baz');
console.log(SyncStorage.getAllKeys()) // ['foo', 'boo']