فصل پیوست ۲: پیاده‌سازی فرآیند login خودکار

Automated Login Process

در جلسه قبل موفق شدیم که داده های خود را درون localStorage ذخیره سازی کنیم اما هنوز فرآیند login خودکار را انجام نداده ایم. ما برای انجام login خودکار باید به فایل App.vue رفته و از lifecycle ای به نام Created استفاده کنیم اما قبل از آن به store.js رفته و action دیگری را تعریف می کنیم. این action مسئول اجرای login خواهد بود و چند شرط مختلف را چک خواهد کرد. در مرحله اول می گوییم:

tryAutoLogin({ commit }) {
  const token = localStorage.getItem('token');
  if (!token) {
    return;
  }
},
logout({ commit }) {
  commit('clearAuthData');
  router.replace('/signin');
},

همانطور که مشخص است من نام این Action را tryAutoLogin گذاشته ام. در قدم اول مقدار token که همان توکن امنیتی ذخیره شده در localStorage است را دریافت کرده و آن را بررسی کرده ام. اگر token وجود نداشته باشد (علامت تعجب در شرط if) یعنی کاربر اصلا login نشده است بنابراین فقط return می کنیم که یعنی از تابع خارج می شویم اما این تنها شرط مورد بررسی ما نیست. شرط بعدی ما expirationDate است! اگر expirationDate از تاریخ فعلی بیشتر باشد یعنی توکن منقضی شده است و اعتباری ندارد بنابراین در این حالت هم نباید سعی در login کردن داشته باشیم:

tryAutoLogin({ commit }) {
  const token = localStorage.getItem('token');
  if (!token) {
    return;
  }
  const expirationDate = localStorage.getItem('expirationDate');
  const now = new Date();
  if (now >= expirationDate) {
    return;
  }
}

مقدار expirationDate در localStorage موجود است و ما می توانیم با متد getItem آن را بگیریم. برای دریافت تاریخ فعلی نیز از new Date استفاده می کنیم. در نهایت در یک شرط if بزرگ تر یا مساوی بودن now را بررسی می کنیم و اگر اینطور بود فقط return می کنیم تا از تابع خارج شویم.

اگر هیچ کدام از این شرط ها صحیح نبودند می توانیم به راحتی login کنیم اما mutation ای که مسئول login کردن کاربر بود به شکل زیر است:

authUser(state, userData) {
  state.idToken = userData.token;
  state.userId = userData.userId;
}

یعنی userData را از ما می خواهد که همان token و userId است. توجه کنید که پاس دادن شیء userData واقعا به همین نام الزامی نیست بلکه باید شیء ای به این mutation پاس داده شود که بتوان از درون آن دو خصوصیت token و userId را استخراج کرد. یکسان بودن نام ها اصلا مهم نیست. بنابراین باید به localStorage برگشته و علاوه بر token و expirationDate، مقدار userId را نیز دریافت کنیم:

signup({ commit, dispatch }, authData) {
  axios
    .post("/accounts:signUp?key=AIzaSyDtirb936QLEAL9Hbkn1st5c3cF3U7_cFI", {
      email: authData.email,
      password: authData.password,
      returnSecureToken: true
    })
    .then(res => {
      console.log(res);
      commit('authUser', {
        token: res.data.idToken,
        userId: res.data.localId
      });
      const now = new Date();
      const expirationDate = new Date(now.getTime() + res.data.expiresIn * 1000);
      const expirationDate = now.getTime() + res.data.expiresIn * 1000;
      localStorage.setItem('token', res.data.idToken);
      localStorage.setItem('userId', res.data.localId);
      localStorage.setItem('expirationDate', expirationDate);
      dispatch('storeUser', authData);
      dispatch('setLogoutTimer', res.data.expiresIn);
    })
    .catch(error => console.log(error));
}

همین کار را در Login نیز انجام می دهیم:

login({ commit, dispatch }, authData) {
  axios
    .post(
      "/accounts:signInWithPassword?key=AIzaSyDtirb936QLEAL9Hbkn1st5c3cF3U7_cFI",
      {
        email: authData.email,
        password: authData.password,
        returnSecureToken: true
      }
    )
    .then(res => {
      console.log(res);
      const now = new Date();
      const expirationDate = new Date(now.getTime() + res.data.expiresIn * 1000);
      localStorage.setItem('token', res.data.idToken);
      localStorage.setItem('userId', res.data.localId);
      localStorage.setItem('expirationDate', expirationDate);
      commit('authUser', {
        token: res.data.idToken,
        userId: res.data.localId
      });
      dispatch('setLogoutTimer', res.data.expiresIn);
    })
    .catch(error => console.log(error));
},

حالا به tryAutoLogin برگشته و این مقدار را از localStorage می گیریم:

tryAutoLogin({ commit }) {
  const token = localStorage.getItem('token');
  if (!token) {
    return;
  }
  const expirationDate = localStorage.getItem('expirationDate');
  const now = new Date();
  if (now >= expirationDate) {
    return;
  }
  const userId = localStorage.getItem('userId');
  commit('authUser', {
    token: token,
    userId: userId
  })
}

در قدم اول باید متد Commit را از شیء context خارج می کردیم تا بتوانیم mutation خود را commit کنیم. سپس userId را دریافت کرده و درون ثابتی به همین نام قرار می دهیم. در نهایت برای Commit کردن یک شیء جاوا اسکریپتی را پاس داده ام که حاوی token و userId باشد. به نظر شما کد بالا کار می کند؟ از آنجایی که از قبل توکن خود را در localStorage داریم، به صفحه Clear Storage می روم و در انتهای آن گزینه Clear Site Data را می زنم تا از صفر و از اول شروع کنیم. حالا اگر دوباره login شویم و صفحه را refresh کنیم، login می شویم؟ خیر! چرا؟ به دلیل اینکه اصلا از tryAutoLogin در هیچ قسمتی از برنامه استفاده نکرده ایم! برای این کار به App.vue می رویم و از lifecycle ای به نام Created استفاده می کنیم:

<script>
import Header from "./components/header/header.vue";
export default {
  name: "app",
  components: {
    "app-header": Header
  },
  created() {
    this.$store.dispatch("tryAutoLogin");
  }
};
</script>

با این کار کدها باید کار کنند و اگر در مرورگر آن ها را تست کنید نیز این اتفاق می افتد (با refresh شدن صفحه، login می شویم) اما مشکلی داریم. پس از کلیک روی دکمه logout (نه refresh شدن صفحه)، مقادیر موجود در localStorage حذف نمی شوند. یادتان باشد که اگر روی دکمه logout کلیک شد، یعنی کاربر نمی خواهد login شود بنابراین باید این مقادیر را حذف کنیم.

برای این کار به فایل Store.js رفته و در اکشن logout بدین شکل عمل می کنیم:

logout({ commit }) {
  commit('clearAuthData');
  localStorage.removeItem('expirationDate');
  localStorage.removeItem('token');
  localStorage.removeItem('userId');
  router.replace('/signin');
},

removeItem باعث حذف شدن آیتم های پاس داده شده از localStorage می شود. البته می توانستیم به جای اینکه تک تک آیتم ها را بدین شکل حذف کنیم از متد clear به شکل زیر استفاده کنیم:

logout({ commit }) {
  commit('clearAuthData');
  localStorage.clear();
  router.replace('/signin');
}

اما در بسیاری از اوقات علاوه بر این گزینه ها، ممکن است داده های دیگری را در localStorage داشته باشیم که نخواهیم حذف شوند. همچنین شما می توانید یک شیء را در localStorage ذخیره کنید تا نیاز نباشد تک تک موارد را جداگانه ثبت و حذف کنید اما یادتان باشد که localStorage فقط مقادیر رشته ای را قبول می کند بنابراین برای ثبت اشیاء باید به شکل زیر عمل کنید:

localStorage.setItem('user', JSON.stringify(user));

JSON.stringify متدی جاوا اسکریپتی است که مقادیر پاس داده شده را به صورت رشته در می آورد. همچنین برای دریافت داده هایی که بدین شکل ذخیره شده اند می گوییم:

const user = JSON.parse(localStorage.getItem('user'));

JSON.parse شیء ما را از حالت رشته ای JSON خارج می کند تا بتوانیم مانند یک شیء عادی از آن استفاده کنیم. چنین مواردی همگی به سلیقه شما بستگی داشته و هیچ راه بهتری وجود ندارد. به شما تبریک می گویم! شما فصل دوم پیوست را نیز تمام کردید! ما از پروژه این فصل در فصل بعدی استفاده خواهیم کرد بنابراین حتما آن را از اینجا دانلود کنید:

دانلود سورس کد نهایی این فصل