A NativeScript plugin to add LocalStorage and SessionStorage If you are trying to use any libraries that use the localStorage/sessionStorage API; or you want a fairly simple storage engine; here it is.
This is released under the MIT License, meaning you are free to include this in any type of program -- However for entities that need a support contract, changes, enhancements and/or a commercial license please contact me at http://nativescript.tools.
I also do contract work; so if you have a module you want built for NativeScript (or any other software projects) feel free to contact me email@example.com.
Supports NativeScript 2.x and greater
Breaking Change from v1 to v2
- V2.00 now forces setItem to be the same as a browser, browsers ONLY allow strings.
If you would like the old behavior; use
tns plugin add nativescript-localstorage
To use the module you just
This will enable the localStorage api. So then you can use it just like a browser.
You can also optionally do:
let LS = ;LS; // Returns: "By Master Technology"
You ask, how exactly does this help?
This allows you to use localStorage or sessionStorage as if it is built into NativeScript.
localStorage.getItem(name) - Get a value from Storage
name - the key to get
This will return whatever you stored in that key, or null if that key doesn't exist.
let me = localStorage || 42;
localStorage.setItem(name, value) - Set a STRING value into storage
name - the key to set
value - the value to set; this can be number or string. Will auto-convert to string.
localStorage.setItemObject(name, value) - Sets a value into storage
name - the key to set
localStorage.removeItem(name) - Delete and item from storage
name - the key to delete
localStorage; // Guess you were eaten and removed! :-)
localStorage.clear() - clear all storage
localStorage.length - Number of items stored
Returns the number of keys stored
localStorage.key(id) - Return the key name at this position
id - 0 based id of the key
returns: string name of the key (or null if id is past size of saved storage )
You can use sessionStorage instead of localStorage for any of the routines above; the difference between the two API's is localStorage saves and will always be present, where sessionStorage is temporary, when you close the program it is gone.