Skip Navigation
  1. BlackBerry Docs
  2. BlackBerry Dynamics SDK for Cordova 4.2
  3. BlackBerry Dynamics SDK for Cordova Development Guide
  4. Using plug-ins to enable your apps
  5. Security of Cordova localStorage

Security of
Cordova
 localStorage

Take note of the following items about the the security of
localStorage
 in relation to
GDSecureStorage
. For more information about
GDSecureStorage
, see the BlackBerry Dynamics API reference.
Item
Description
Use localStorage.getLength(), not localStorage.length
To get the length of
GDSecureStorage
, do not use
localStorage.length
. Use the following method instead:
localStorage.getLength()
This method returns the size of "localStorage" (
GDSecureStorage
).
localStorage operations secured by the SDK
  • If you use
    localStorage.setItem(key, value)
     to write values to
    localStorage
    , it is stored in
    GDSecureStorage
     and is protected.
  • If you use
    localStorage.getItem(key)
     to read values from
    localStorage
    , it is read from
    GDSecureStorage
    .
  • If you use
    localStorage.removeItem(key)
     to remove some value from
    localStorage
    , it is removed from
    GDSecureStorage
    .
  • If you use
    localStorage.key(index)
     to get the key by index from
    localStorage
    , the key is retrieved from
    GDSecureStorage
    .
  • If you use
    localStorage.clear()
     to clear
    localStorage
    ,
    GDSecureStorage
     is cleared.
localStorage operations not secured by the SDK
  • If you write values to
    localStorage
     with
    localStorage[key] = value
     the value is not stored in
    GDSecureStorage
     and is not protected. It is stored in the native
    Storage
     object.
  • If you read a value from
    localStorage
     with
    var value = localStorage[key]
     the value is not retrieved from
    GDSecureStorage
     but from the native
    Storage
     object.
  • If you use
    localStorage.length
     to get the size of
    localStorage
    , this returns the length of native
    Storage
     object, not the length of
    GDSecureStorage
    . Use
    localStorage.getLength()
     instead.