React NativeAsyncStorage # | Edit on GitHub |
AsyncStorage is a simple, asynchronous, persistent, key-value storage system that is global to the app. It should be used instead of LocalStorage.
It is recommended that you use an abstraction on top of AsyncStorage instead of AsyncStorage directly for anything more than light usage since it -operates globally.
This JS code is a simple facade over the native iOS implementation to provide -a clear JS API, real Error objects, and simple non-multi functions. Each +operates globally.
On iOS, AsyncStorage is backed by native code that stores small values in a serialized
+dictionary and larger values in separate files. On Android, AsyncStorage will use either
+RocksDB or SQLite based on what is available. This JS code is a simple facade that
+provides a clear JS API, real Error objects, and simple non-multi functions. Each
method returns a Promise object.
Methods #
static getItem(key, callback?) #
Fetches key and passes the result to callback, along with an Error if
there is any. Returns a Promise object.
static setItem(key, value, callback?) #
Sets value for key and calls callback on completion, along with an
Error if there is any. Returns a Promise object.
static removeItem(key, callback?) #
Returns a Promise object.
static mergeItem(key, value, callback?) #
Merges existing value with input value, assuming they are stringified json.