AsyncStorage

Learn persistent data storage with AsyncStorage.

What is AsyncStorage?

AsyncStorage is a persistent key-value store in React Native. Data survives even when the app is closed; it can be read when the app reopens. It is suitable for storing user preferences, login state or cached data.

AsyncStorage has been separated from the React Native core; it is installed as the @react-native-async-storage/async-storage package. All operations are asynchronous; you wait with await. Values are stored as strings; to store numbers or objects you need to convert them.

Installation and import

To use AsyncStorage you first install the package: npm install @react-native-async-storage/async-storage. With Expo you use npx expo install @react-native-async-storage/async-storage. After installation you import the default export.

import AsyncStorage from '@react-native-async-storage/async-storage';

AsyncStorage is not a named export but a default export; you import it without curly braces. After installation you can use the setItem, getItem and removeItem methods.

Exercise Your turn: import AsyncStorage

Import AsyncStorage as a default export from the @react-native-async-storage/async-storage package.

Show example solution

import AsyncStorage from '@react-native-async-storage/async-storage';

Test yourself

What kind of data does AsyncStorage store?
- Temporary non-persistent data
- Only images
- Key-value pairs
- Only numbers
Show answer

Key-value pairs — AsyncStorage stores key-value pairs.

Fill in the blank: import AsyncStorage

import ____ from '@react-native-async-storage/async-storage';

Show answer

import AsyncStorage from '@react-native-async-storage/async-storage';

Match: method and role

setItem

write data
getItem

read data
removeItem

delete data

Next lesson: setItem

We Are Enhancing Your Experience

Cookie Preferences

Strictly Necessary Cookies

Analytical Cookies