AsyncStorage Handler

An improved form of working with react-native asyncstorage.

Getting Started

These instructions will get you a copy of the project up and running on your local machine for development and testing purposes. See deployment for notes on how to deploy the project on a live system.

Prerequisites

This handler works strictly with react native. Works with both the

create-react-app <app-name>

and the

react-native init <app-name>

of react native.

Installing

To Install the handler

npm install asyncstoragehandler --save

Usage

1.Import asyncstoragehandler:

import Handler from 'asyncstoragehandler'

2.Set one of the states in the constructor to be the handler:

constructor(){
  super();
  this.state = {
    Handler : new Handler()
  }
}

Complete Example

A complete example on saving data.

import React, { Component } from "react";
import { Text, TouchableOpacity, View } from "react-native";
import Handler from "asyncstoragehandler";

export default class HandlerTexter extends Component {
  state = {
    Handler: new Handler()
  };

  _setData = async() => {
    let data = {
      title : "handler test"
    }
    this.state.Handler.setItem('@KEY',data)
    .then((value) => {
      if(value){
        alert("saved");
      }else{
         alert("not saved");
      }
    });
  }

  render() {
    return (
      <View style={{ flex: 1 }}>
        <TouchableOpacity onPress={this._setData}>
          <Text>Save Data</Text>
        </TouchableOpacity>
      </View>
    );
  }
}

Functions and Description

| Functions | Description | | --- | --- | | setItem(key: string, value: string) | Persist a value to asyncStorage for a key. Returns a Promise object | | setItemArray(key: string, value: string) | Persist an array value to asyncStorage for a key. Returns a Promise object | | getItem(key: string) | Gets an item (including array) for a key. Returns a Promise object | | updateItem(key: string, value: string) | Updates a value to asyncStorage for a key. Returns a Promise object | | updateItemArray(key: string, index: integer, value: string) | Update an element from the array value for a key. Returns a Promise object | | deleteItem(key: string) | Removes an item for a key . Returns a Promise object. | | deleteItemArray(key: string, index: integer) | Removes an element from the array value for a key. Returns a Promise object | | clearAllItem(key: string) | Erases all Item for all clients, libraries, etc. Returns a Promise object. |

Authors

• Musa Joshua

License

This project is licensed under the MIT License - see the LICENSE.md file for details

Acknowledgments

• Hat tip to anyone whose code was used directly or indirectly.
• Inspiration
• etc