peterpme/react-native-asyncstorage

📬 📫 🗄 Declarative AsyncStorage component for React Native

react-native-asyncstorage

📬 📫 🗄 Declarative AsyncStorage component for React Native

• Installation
• API
• Usage Examples

Installation

yarn add react-native-asyncstorage

or

npm install --save react-native-asyncstorage

API

• AsyncStorage.GetItem
• AsyncStorage.SetItem

AsyncStorage.GetItem

itemKey:  string
render: {
  loading: boolean,
  value: string | object,
  error: string
}

AsyncStorage.SetItem

itemKey: string
itemValue: string | object
render: {
  loading: boolean,
  value: string | object,
  error: string
}

Usage Examples

• Fetch username from AsyncStorage before rendering the rest of your app

<AsyncStorage.GetItem
  itemKey='username'
  render={({ loading, value, error }) => {

    if (loading) return <AppLoading />
    
    return (
      <View style={styles.container}>
        <Text>Welcome to my app, ${value}</Text>
      </View>
    )
    
  }}
/>

Planned Updates

• multiGet & multiSet support for multiple keys

Shoutout

Thanks to @tkh44 for the idea and his localforage version. He makes a lot of great shit, follow him on Twitter