Skip to content
master
Go to file
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
 
 
 
 
 
 
 
 
 
 

README.md

react-native-user-defaults

Version js-standard-style Circle CI

When to use UserDefaults

when you want to store some small ,insensitive and permanent information in your app

Installation

  1. npm install react-native-user-defaults
  2. open xcode, right click on Libraries, then click Add Files..., select node_modules -> react-native-user-defaults -> RCTUserDefaults.xcodeproj
  3. still in xcode, select main project file, then Build Phases -> Link Binary... -> Add items -> libRCTUserDefaults.a

If you are not clear about the step 2 and 3, you can check react-native official doc , follow the step 1 and 2 in the official doc.

Usage

In objective-c and swift, you have to use specific method for specific type, like setObject and stringForKey. But in react-native, I believe that all you need is just set and get.

Every method supports callback and promise

import userDefaults from 'react-native-user-defaults'

Set information for a key

set({String}, {String, Number, Bool, Object, Array}, [,suiteName] [,callback])

Example:
userDefaults.set("key1", "valueIsString")
 .then(data => console.log(data))   // Save success

userDefaults.set("key2", [1, true], "group.com.company.app", (err, data) => {
 if(!err) console.log(data)         // Save success
})

Get information of a key

get({String} [,suiteName] [,callback])

Example:
userDefaults.get("key1")
 .then(data => console.log(data))   // value for the key1

userDefaults.get("key2", "group.com.company.app", (err, data) => {
 if(!err) console.log(data)         // value for the key2
})

Remove an item

remove({String} [,suiteName] [,callback])

Example:
userDefaults.remove("key1")
 .then(data => console.log(data))   // Remove success

Empty all items which are not default(APP default settings will be reserved)

empty([suiteName] [,callback])

Example:
userDefaults.empty()
 .then(data => console.log(data))   // Empty success

Troubleshooting

  1. No tests? I have tested all methods, I promise. I've checked other famous react-native components, they all don't have tests, I think we are all seeking a way of formal tests.
  2. Why not swift? I wrote this in swift at the beginning, but I find it's hard for others and even myself to integrate it into an existed project.
  3. Type bug? if you set('key1', '12'), then get('key1'), you will get 12, not '12', I don't take this as a bug so that we can use this component more conveniently. If you don't think so, tell me.

License

MIT

About

All you need is set and get

Resources

License

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •  
You can’t perform that action at this time.