cross-domain-local-storage-separately

As for now, standard HTML5 Web Storage (a.k.a Local Storage) doesn't now allow cross domain data sharing. This may be a big problem in an organization which have a lot of sub domains and wants to share client data between them.


License
MIT
Install
npm install cross-domain-local-storage-separately@1.0.0

Documentation

Cross Domain Local Storage Separately - Based on iframe tag

  1. Problem
  2. Solution
  3. Why not use cookies?
  4. Installation
  5. Usage
  6. API
  7. Limitations

Problem

As for now, standard HTML5 Web Storage (a.k.a Local Storage) doesn't now allow cross domain data sharing. This may be a big problem in an organization which have a lot of sub domains and wants to share client data between them. However, you maybe want to save/delete/clear key&value for each sub domains. This project was modified for my purpose from 'https://github.com/ofirdagan/cross-domain-local-storage'. Thank ofirdagan for sharing code.

Solution

xdLocalStorage is a lightweight js library which implements LocalStorage interface and support cross domain storage by using iframe post message communication independently.

Why not use cookies?

Although cookies can be shared between sub domains, cookies have the overhead of being sent to the server on each request. They're also have a size limit (4K for all cookies together)

Installation

Download latest release from here or use bower/npm (recommended)

npm install --save xdlocalstorage-separately
or
yarn add xdlocalstorage-separately

Usage

  • You have two steps:

    • write embedded html.
    • write client html.
  • Create an empty(embedded) html with the following content:

<!DOCTYPE html>
<html>
<head>
    <script src="xdLocalStoragePostMessageApi.min.js"></script>
</head>
<body>
    This is the magical iframe
    <script type="text/javascript">
    window.onload = function() {
      // must call init function
      xdLocalStorageEmbedded.init( "sub.domain.com" );
    };
</script>
</body>
</html>
  • On your client page (the page you will read/store your data from) add:
 <!-- if you use angular continue reading.. there's angular support -->
 <script src="scripts/xdLocalStorage.min.js"></script>
  • Init xdLocalStorage
    xdLocalStorage.init(
        {
            /* required */
            iframeUrl:'path to your html from step 1',
            nameSpace: "sub.domain.com",    /* required uniquely */
            //an option function to be called right after the iframe was loaded and ready for action
            initCallback: function (data) {
                console.log('Got iframe ready:' + data.ns);
            }
        }
    );

ES6

  • only once import package
  • yarn add xdlocalstorage-separately
import 'xdlocalstorage-separately'

windows.xdLocalStorage.init(
        {
            /* required */
            iframeUrl:'path to your html from step 1',
            nameSpace: "sub.domain.com",    /* required uniquely */
            //an option function to be called right after the iframe was loaded and ready for action
            initCallback: function (data) {
                console.log('Got iframe ready:' + data.ns);
            }
        }
    );

API

    // Store
    xdLocalStorage.setItem("sub.domain.com", key, value, function (data) { /* callback */ });

    // Retrieve
    xdLocalStorage.getItem("sub.domain.com", key, function (data) { /* callback */ });

    // Remove
    xdLocalStorage.removeItem("sub.domain.com", key, function (data) { /* callback */ });

    // Key Name
    xdLocalStorage.key("sub.domain.com", index, function (data) { /* callback */ });

    // Clear All
    xdLocalStorage.clear("sub.domain.com", function (data) { /* callback */ });

Limitations

Apple has updated the defaults on Safari 7+ both on desktop and mobile to block 3rd party data. The option is now called "Block cookies and other website data" which refers to things like localstorage which are now completely isolated by domain.

This implies that unfortunately this library will not be able to share cross domain information on Safari 7+.