وب‌سرویس مجید

پروژه apollo-storybook-decorator

abhiaiyer91/apollo-storybook-decorator

این پروژه یک دکوراتور برای Storybook فراهم می‌کند که امکان پیچیدن محیط استوری‌بوک با Apollo Client را فراهم می‌کند.

با استفاده از آن می‌توانید داده‌های شبیه‌سازی‌شده (mocks) برای درخواست‌های GraphQL تعریف کنید و کامپوننت‌های رابط کاربری را به صورت ایزوله و بدون وابستگی به سرور تست کنید.

کاربرد:

این ابزار برای توسعه‌دهندگانی که از Apollo Client و GraphQL در پروژه‌های ری‌اکت (یا دیگر فریم‌ورک‌ها) استفاده می‌کنند، بسیار مفید است.

شما می‌توانید استوری‌های Storybook خود را با داده‌های شبیه‌سازی‌شده از پیش تعریف‌شده رندر کنید و رفتار کامپوننت‌ها را در حالت‌های مختلف داده‌ای بررسی کنید.

در چه شرایطی بهتره استفاده شود؟

وقتی که می‌خواهید کامپوننت‌های وابسته به داده‌های GraphQL را به صورت مستقل توسعه و تست کنید.

همچنین در محیط‌های توسعه، وقتی سرور GraphQL هنوز آماده نیست یا دسترسی به آن سخت است، این ابزار کمک بزرگی است.

همچنین برای تست‌های بصری (visual testing) و مستندسازی کامپوننت‌ها عالی عمل می‌کند.

چند مثال از موارد استفاده

نمایش یک لیست کاربران با داده‌های فیک در استوری‌بوک

تست کامپوننت "جزئیات محصول" در حالت‌های مختلف (بارگذاری، خطا، داده معتبر)

شبیه‌سازی خطاهای GraphQL برای تست رفتار کامپوننت در شرایط خطا

توسعه موازی فرانت‌اند و بک‌اند بدون نیاز به API واقعی

  • ##storybook
  • ##apolloclient
  • ##graphql
  • ##react
  • ##componenttesting
  • ##uimocks
  • ##frontend
  • ##testing
  • ##mockdata
  • ##visualtesting