Skip to content

A simplistic session plugin for Vue 3 backed by SessionStorage and LocalStorage. May be helpful for simple session management.

Notifications You must be signed in to change notification settings

inderweb/vue-session

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

26 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

To install the plugin, do the following:

import VueSession from 'vue-session'
const app = createApp(App); // your normal Vue 3 app code
app.use(VueSession)

Now you can inject this inside your component.

const $session = inject('$vsession');
$session.get('your_key');

Options

VueSession can be started with some options that will change its behavior.

  • persist A Boolean value to determine whether the data stored in the session may persist between tabs and browser instances. Defaults to false.

Pass the options in the use method:

var options = {
    persist: true
}

app.use(VueSession, options)

Reference

  • $session.getAll(), returns all data stored in the Session.
  • $session.set(key,value), sets a single value to the Session.
  • $session.get(key), returns the value attributed to the given key.
  • $session.start(), initializes a session with a 'session-id'. If you attempt to save a value without having started a new session, the plugin will automatically start a new $session.
  • $session.exists(), checks whether a session has been initialized or not.
  • $session.has(key), checks whether the key exists in the Session
  • $session.remove(key), removes the given key from the Session
  • $session.clear(), clear all keys in the Session, except for 'session-id', keeping the Session alive
  • $session.destroy(), destroys the Session
  • $session.id(), returns the 'session-id'
  • $session.renew(session_id), allows a user to renew a previous session by manually inputting the session_id

Flash

Flash allows you to save data until you read them without having to start a regular Session.

  • $session.flash.set(key, value), sets a flash value
  • $session.flash.get(key), reads and removes a flash value
  • $session.flash.remove(key), removes a flash value

Example

Your login method could look like this:

import { inject } from "vue";

export default {
  setup(props, { emit }) { //props, context
    // Inside vue-session we are using provide, so you can inject it further
    // app.provide('$vsession', $vsession);

    const $session = inject('$vsession');
    const handleSubmit = () => {
      // your validation code
      // your method code
      // your API logics...
      
      // sample code
      axios.post(YOUR_API_URL + '?_format=json', JSON.stringify(YOUR_JSON), {
          headers: {
            'Content-Type': 'application/x-www-form-urlencoded',
            'X-CSRF-Token': sessionToken
          },
          withCredentials: true
        })
          .then(userResponse => {
            $session.start()
            $session.set('token', userResponse.csrf_token)
            $session.set('isLoggedIn', true);
            $session.set('uid', userResponse.uid)
            resolve(userResponse)
          })
          .catch(error => {
            // handle any errors
            if (error.response.status == 403) {
              console.log('User already logged in! ' + $session.get('token'))
            }
            let message = error.response.data.message
            reject(message)
          })
    }
    return {
      handleSubmit
    };
}

In your logged-in area, you can check whether or not a session is started and destroy it when the user wants to logout.

const $session = app.config.globalProperties.$vsession
let $uid = $session.get('uid'); // if you ar setting uid while log in action

// or another way
// Helper for checking route auth. Will check if auth is needed,
// redirects to login page is page is restricted.
export const requireAuth = (to, from, next) => {
  if ($session.exists()) {
    if (!$session.get('isLoggedIn')) {
      $session.destroy()
      next('/login')
    } else {
      next()
    }
  } else {
    next('/login')
  }
}

Hope this is helpful ! I am available for any support/consultancy :-)

About

A simplistic session plugin for Vue 3 backed by SessionStorage and LocalStorage. May be helpful for simple session management.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • JavaScript 100.0%