1.1.1 • Published 3 years ago

use-storage-listener v1.1.1

Weekly downloads
-
License
MIT
Repository
github
Last release
3 years ago

useStorageListener 👨🏾‍🎤👩🏾‍🎤🧑🏾‍🎤

Installation

Sometimes we need to be able to detect changes in our localSotrage independently from the .* file we have made the modification, useStorageListener provides a dynamic way to listen for keys that are modified in the local storage in a simple and fast way, either using the listener effect or the state handler.

note: The listener effect can listen to other events that are not related to the localStorage, simply specify the name of the event to listen to 🧐

(i) new auto type transformation 1.1.1 🧩

Using npm or yarn:

$ npm i use-storage-listener
$ yarn add use-storage-listener

Simple use - useStorageListener:

import useStorageListener, { setStorage } from 'use-storage-listener';

function Test() {
 const [value, setValue] = useState(null)
 
  useStorageListener(({ key, value}) => {
    setValue(value)
  }, ['rememberMe'])

  const set = (remember) => {
    setStorage('rememberMe', remember);
  }
  return (
    <div className="App">
      <header className="App-header">
        <h1>{value}</h1>
        <button onClick={() => set('nice work!')}>ONCLICK</button>
      </header>
    </div>
  );
}

Simple use - useLocalStorage:

import { useLocalStorage } from 'use-storage-listener';

function Test() {
 const {state, setState} = useLocalStorage('rememberMe');
 
  return (
    <div className="App">
      <header className="App-header">
        <h1>{state}</h1>
        <button onClick={() => setState('simple work!')}>ONCLICK</button>
      </header>
    </div>
  );
}

Hooks:

nameParams
useLocalStoragecallback: void dependencies: string[]
useStorageListenerkey: string

Options:

OptionParamsDescription
setStoragekey: string arg: anywhen it receives a key and a value, it will add these to the store, or update the value if the key already exists (triggers useStorageListener)
removeStoragekey: stringdeletes the key whose name it receives as a parameter from storage (triggers useStorageListener)
getStoragekey: stringwhen passed a key name, will return that key's value, or null if the key does not exist, in the given Storage object
clearStoragecallEventKey?: stringdeletes the key whose name it receives as a parameter from storage (Activates useStorageListener if callEventKey is provided)
1.1.1

3 years ago

1.1.0

3 years ago

1.0.7

3 years ago

1.0.6

3 years ago

1.0.5

3 years ago

1.0.4

3 years ago

1.0.3

3 years ago

1.0.2

3 years ago

1.0.1

3 years ago

1.0.0

3 years ago