Git Product home page Git Product logo

vuex-shared-mutations's Introduction

vuex-shared-mutations

Share certain Vuex mutations across multiple tabs/windows. NPM version Build Status BrowserStack Status

Installation

$ npm install vuex-shared-mutations

Usage

import createMutationsSharer from "vuex-shared-mutations";

const store = new Vuex.Store({
  // ...
  plugins: [createMutationsSharer({ predicate: ["mutation1", "mutation2"] })]
});

Same as:

import createMutationsSharer from "vuex-shared-mutations";

const store = new Vuex.Store({
  // ...
  plugins: [
    createMutationsSharer({
      predicate: (mutation, state) => {
        const predicate = ["mutation1", "mutation2"];
        // Conditionally trigger other plugins subscription event here to
        // have them called only once (in the tab where the commit happened)
        // ie. save certain values to localStorage
        // pluginStateChanged(mutation, state)
        return predicate.indexOf(mutation.type) >= 0;
      }
    })
  ]
});

API

createMutationsSharer([options])

Creates a new instance of the plugin with the given options. The following options can be provided to configure the plugin for your specific needs:

  • predicate <Array<string> | (mutation: { type: string, payload: any }, state: any) => boolean>: Either an array of mutation types to be shared or predicate function, which accepts whole mutation object (and state) and returns true if this mutation should be shared.
  • strategy: { addEventListener: (fn: function) => any, share(any) => any } - strategy is an object which provides two functions:
    • addEventListener - plugin will subscribe to changes events using this function
    • share - plugin will call this function when data should be shared

How it works

Initially, this plugin started as a small plugin to share data between tabs using localStorage. But several inconsistencies in Internet Explorer lead to entire plugin rewrite and now it is not tied to localStorage anymore If you do not supply strategy system will use BroadcastChannel if available and downgrade to localStorage if it fails.

If you need to configure strategies you can do that by hand, for example:

import createMutationsSharer, { BroadcastStrategy } from 'vuex-shared-mutations';

const store = new Vuex.Store({
  // ...
  plugins: [
    createMutationsSharer({
      predicate: ['m-1'],
      strategy: new BroadcastStrategy({ key: 'CHANNEL_NAME' })
    }),
  ],
});

Options accepted by BroadcastStrategy: - key: string - channel name, using for sharing

Options accepted by LocalStorageStrategy: - key: string - key, used in localStorage (default: 'vuex-shared-mutations') - maxMessageLength: number - In some browsers (hello, Internet Explorer), when you're setting big payload on localStorage, "storage" event is not triggered. This strategy bypasses it by splitting message in chunk. If you do not need to support old browsers, you can increase this number (default: 4096)

Contributing

  • Fork
  • > git clone
  • > npm install
  • Make your changes
  • > npm run test (assuming you have Chrome installed in your system)
  • > npm run lint
  • If everything is passing: - Update CHANGELOG.md - Commit and Make a pull request

License

MIT © Illya Klymov

vuex-shared-mutations's People

Contributors

xanf avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

vuex-shared-mutations's Issues

Unable to parse shared mutation data

OS: macOs 10.14.1
Bug reproduced in:

  • Chrome 70.0.3538.102 (Official Build) (64-bit)
  • Safari 12.0.1 (14606.2.104.1.1)
  • Opera 56.0.3051.52

Not reproduced in:

  • Firefox 62.0.3 (64-bit);

I'm getting errors with last version of package (0.0.5).

vuex-shared-mutations.js:67 [vuex-shared-mutations] Unable to parse shared mutation data
vuex-shared-mutations.js:68 notification TypeError: Cannot read property 'type' of null at eval

Namespaced Predicates

Hey I was wondering how to use this with namespaced vuex modules. I have a few different modules.

  • User
  • Auth

I tried adding them to my predicates like they do in the demo example you have provided. For example:

'auth/login'

This doesn't seem to work. My application no longer recognizes this mutation.

Possible to use indexeddb?

Hello is it possible to perhaps use indexeddb using localForage instead of localstorage? I have a large set of data that im mutating. Are there any plans to provide this option?

Thank you

Kind regards

1.0 release plan

  • Switch to jest as testing platform
  • Add abstraction over localstorage to allow custom storages
  • Add proper typings (both for Flow & TypeScript)
  • Add examples

State doesn't update after mutation

I open two windows in Chrome, sell product in the first one. In the second mutation proceed, but state doesn't updated. Do you know why it can be happening?

Pusher.js?

Did I understood right? We can use this plugin and broadcast changes via Pusher.js?

Repeated mutation only shared first time

The "storage" event seems to be fired only when localStorage is changed (tested in Google Chrome 56), that is, not if the same change is made twice:

// In tab #1
window.addEventListener('storage', console.log)

// In tab #2
localStorage.x = 'a'
localStorage.x = 'b'
localStorage.x = 'a'
localStorage.x = 'a'

// In tab #1
// console.log only fired 3 times, not 4

Because this plugin doesn't reset the the value between setting mutation, the counter example (after adding this plugin) wouldn't sync as expected (the same "increment" mutation would be committed multiple times, but only the first one is shared).

To fix this, reset the value after setting it (window.localStorage.removeItem(key); in store.subscribe) and abort in the event listener (if (event.newValue === null) return;)

Fix "how it works" readme example

In your readme, in the "Hot it Works" section, says to use

..... new BroadcastStrategy({key:.....})........

if u do that the console shows:

Uncaught TypeError: vuex_shared_mutations__WEBPACK_IMPORTED_MODULE_2__.BroadcastStrategy is not a constructor

What u really must do is

..... new BroadcastChannelStrategy({key:.....})........

The Channel part is missing... at least that's how i made it work

Disable error log in production.

Thank you for your plugin.
I using this plugin in Nuxt.js on production server.

But i got many logs.

[vuex-shared-mutations] localStorage is not available. Disabling plugin
[vuex-shared-mutations] localStorage is not available. Disabling plugin
[vuex-shared-mutations] localStorage is not available. Disabling plugin

Are you planning to implement logging off?

Doesn't seem to work with websockets

Please see details here along with a non vuex-shared-mutations workaround.
https://stackoverflow.com/questions/55818416/vue-sharing-websocket-data-across-browser-tabs/55834773#55834773

This may be due to the websocket never triggering the second browser tabs mutations. Relevant code is most likely this: https://github.com/nathantsoi/vue-native-websocket/blob/master/src/Observer.js#L83-L100

If there is something that can be done from vuex-shared-mutations, please let me know. If this falls outside of this packages responsibilities, please respond indicating that, and close the ticket.

The state only get shared on mutation commits

When I try to create multiple instances of my store, the plugin work fine sharing the datas between it, but only when I commit a mutation all instances get updated.

If I don't commit a mutation the secondary storage instances still with default values instead take the states of first vuex instance.

Any way to sync states on init?

IE11 Syntax Error

Fairly standard install of nuxt used in conjunction with this plugin causes a syntax error on IE11:

screen shot 2018-05-02 at 12 16 53 am

The SyntaxError is also occurring in vuex-shared-mutations.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.