APIها ستون فقرات برنامه های کاربردی مدرن هستند و همه چیز را از احراز هویت کاربر گرفته تا جمع آوری داده های پیچیده را تامین می کنند. ما می‌دانیم که برقراری تماس‌های API به صورت جداگانه ضرری ندارد، اگر مثلاً 5 درخواست در یک مجموعه داشته باشید. اما اگر 10، 50 یا بیشتر نقطه پایانی API برای آزمایش، تأیید پاسخ‌ها و اطمینان از کارکرد همه چیز در محیط‌ها دارید، در این صورت، کل فرآیند نه تنها ناکارآمد و به‌شدت خسته‌کننده می‌شود، بلکه مستعد خطاهای انسانی نیز می‌شود.
را دونده مجموعه با خودکار کردن تست API برای کل مجموعه، حذف وظایف تکراری، اطمینان از ثبات، و صرفه جویی در ساعت ها از سردردهای رفع اشکال، این بار را از دوش شما برمی دارد. در این وبلاگ دقیقا نحوه کارکرد آن را توضیح خواهیم داد. ما شما را با انواع مختلف Hoppscotch's Collection Runner آشنا خواهیم کرد، بنابراین شما به راحتی می توانید بر اساس نیازهای خاص خود انتخاب کنید.
با Hoppscotch آشنا شوید 👽
Hoppscotch یک پلت فرم منبع باز و خود میزبان است که توسعه API، آزمایش، اشکال زدایی و مستندسازی پیاده روی در پارک را انجام می دهد. این طراحی شده است که مستقیماً در مرورگر شما بدون نصب، بدون تنظیمات پیچیده و بدون نیاز به حساب کار کند. فقط به hoppscotch.io بروید، درخواست‌های خود را بنویسید، و شما آماده هستید.
Hoppscotch را ببینید 🛸
کالکشن رانر ▶️
در Hoppscotch، ما وسواس داریم که تست API را سریع، آسان، و به جرأت بگوییم ✨ سرگرم کننده ✨ کنیم. Collection Runner برای آن هک نهایی شماست. به‌جای اینکه از طریق درخواست‌های فردی رد کنید، فقط یک بار آن را راه‌اندازی می‌کنید، اجرا را فشار می‌دهید و تماشا می‌کنید که کل مجموعه شما به ترتیب اجرا می‌شود، اعتبارسنجی می‌شود و در عرض چند ثانیه به شما گزارش می‌شود. این مانند قرار دادن تست های API خود در خلبان خودکار است.
📟 دونده مجموعه مبتنی بر Hoppscotch CLI
را نسخه CLI Hoppscotch به عنوان یک نیروگاه برای توسعه دهندگانی که کار در ترمینال را ترجیح می دهند کار می کند. اگر از آن دسته افرادی هستید که ترجیح می دهید از طریق خط فرمان کار کنید، این بلیط شما برای شروع است. تنها کاری که باید انجام دهید این است که پیش نیازها را بر اساس تنظیمات سیستم خود بررسی کنید، نسخه Node خود را تأیید کنید ( v20+ و آخرین نسخه Hoppscotch CLI را با این دستور ساده نصب کنید:
npm i -g @hoppscotch/cli
هنگامی که سرور برنامه خود را راه اندازی کردید، به بخش REST API Hoppscotch بروید، مجموعه ای برای API های برنامه خود ایجاد کنید و در صورت نیاز یک محیط راه اندازی کنید. حالا، اینجا جایی است که همه چیز خوب می شود. شما دو راه برای اجرای مجموعه خود با Hoppscotch CLI دارید:
➡️ استفاده از JSON Exports: مجموعه و محیط مرتبط خود را در قالب JSON صادر کنید و آن را در کنار آن ارسال کنید hopp test دستور برای دریافت خلاصه آزمون:
hopp test [-e ]
➡️ استفاده از شناسه ها: اگر نمی خواهید هیچ فایلی را به صورت محلی دانلود کنید، می توانید از این روش استفاده کنید. هر بار که یک مجموعه یا محیط ایجاد می کنید، Hoppscotch به آنها شناسه های منحصر به فرد اختصاص می دهد. می توانید با استفاده از این شناسه ها از طریق CLI تست ها را اجرا کنید. برای اتصال حساب نمونه خود (Self-hosted یا Cloud) با Hoppscotch CLI، به یک رمز دسترسی شخصی نیز نیاز دارید. و اگر از یک نمونه خود میزبان Hoppscotch استفاده می کنید، فراموش نکنید که URL سرور را نیز وارد کنید:
hopp test [-e ] [--token ] [--server ]
اگر به دنبال موارد زیر هستید، Collection Runner مبتنی بر Hoppscotch CLI دقیقاً در جریان کاری شما قرار می گیرد:
✅ تست API را خودکار کنید و CLI را با فرآیندهای خودکار ادغام کنید و اطمینان حاصل کنید که API های شما به عنوان بخشی از خط لوله ساخت و استقرار شما آزمایش می شوند. (این وبلاگ را بررسی کنید تا به طور کامل در این مورد بیاموزید).
✅ تولید کنید JUnit گزارش می دهد خلاصه آزمون برای ردیابی ساختار یافته نتایج آزمون.
✅ مجموعه های آزمایشی در مقیاس بزرگ را اجرا کنید بدون هیچ زحمتی از راه اندازی دستی هر درخواست.
✅ دویدن تست در محیط های مختلف به سادگی با ارجاع به متغیرهای محیطی و تنظیمات در خط فرمان خود.
✅ تست در برابر نمونه های خود میزبان از Hoppscotch، به شما کنترل کامل بر فرآیند آزمایش را می دهد و در عین حال همه چیز را ایمن نگه می دارد.
✅ تست های خود را به راحتی در چندین نقطه پایانی و موارد استفاده مقیاس بندی کنید و اعتبارسنجی API جامع تر را در زمان کمتری امکان پذیر می کند.
✅ به سرعت اشکال زدایی API ها با اجرای مجموعه‌های آزمایشی با نتایج بی‌درنگ، و اطمینان از اینکه برنامه شما پس از هر به‌روزرسانی به‌طور روان اجرا می‌شود.
✅ تست ها را به راحتی روی سرورهای راه دور اجرا کنید، آن را برای آزمایش API در سیستم های توزیع شده یا محیط های ابری ایده آل می کند.
✅ آزمایشات را بر اساس شرایط خاص آغاز کنید، به شما این امکان را می دهد که آزمایش ها را فقط زمانی اجرا کنید که معیارهای خاصی برآورده شده باشند (مثلاً پس از انجام تعهدات جدید یا پس از مرحله خاصی از فرآیند استقرار شما).
برای یک نمای کلی از Hoppscotch CLI و نحوه عملکرد آن به مستندات مراجعه کنید. به علاوه، ویدیوی پیوست شده زیر را تماشا کنید تا بدانید چگونه یک مجموعه را با استفاده از Hoppsoctch CLI اجرا کنید.
https://www.youtube.com/watch?v=YuplpX4c1ws
🌐 دونده مجموعه مبتنی بر وب Hoppscotch
را نسخه رابط کاربری گرافیکی مجموعه Runner برای لحظاتی که می خواهید تست های خود را به صورت بصری بدون هیچ زحمتی تنظیمات اضافی مدیریت کنید، عالی است. این بسیار راحت است، به خصوص زمانی که می خواهید در حین کار بر روی مجموعه خود، یک خلاصه آزمایشی را در کنار هم ایجاد کنید. تنها کاری که باید انجام دهید این است که مجموعه خود را انتخاب کنید، محیط خود را تنظیم کنید و اجازه دهید دونده از بقیه مراقبت کند.
هنگامی که ماوس را روی مجموعه خود نگه دارید، آن را مشاهده خواهید کرد دونده نماد، که تنظیمات مختلفی را برای شما باز می کند، از جمله:
➡️ تاخیر: یک تأخیر فاصله (بر حسب میلی ثانیه) بین هر درخواست در اجرای مجموعه خود تنظیم کنید.
➡️ توقف اجرای در صورت بروز خطا: اگر خطایی در یک اسکریپت ظاهر شود یا مشکلی در ارسال درخواست وجود داشته باشد، کل اجرا متوقف می‌شود، بنابراین در اینجا موقعیت‌های نامرتب وجود ندارد.
➡️ پاسخ های مداوم: سرصفحه‌ها و بدنه‌های پاسخ را برای بررسی بعدی ثبت کنید. (به خاطر داشته باشید، اگر مجموعه بزرگی دارید، ممکن است این کار سرعت را کاهش دهد.)
➡️ مقادیر متغیر را حفظ کنید: متغیرهای مورد استفاده در طول اجرا را ذخیره کنید. هر به روز رسانی انجام شده برای متغیرها پس از اتمام اجرا باقی می ماند.
پس از آماده شدن، کلیک کنید Run، یک برگه جدید باز می شود که نتایج آزمایش و جزئیات اجرا را نشان می دهد. می‌توانید برای عیب‌یابی یا صرفاً در شکوه اجرای موفقیت‌آمیز، در هر مورد آزمایشی رد شده یا ناموفق عمیق‌تر بگردید.
اجرای مجموعه مبتنی بر وب دقیقاً همان چیزی است که وقتی می خواهید به آن نیاز دارید:
✅ به سرعت بدون نگرانی تست ها را اجرا کنید راه اندازی یا تنظیمات پیچیده.
✅ آزمایشات خود را به صورت بصری پیگیری کنید با خلاصه‌ای بی‌درنگ از هر درخواست و نتایج آن.
✅ نتایج را بررسی و اشکال زدایی کنید با دسترسی آسان به جزئیات مورد آزمایش در صورت شکست چیزی.
✅ اجرا کنید تست در یک محیط تعاملی، ایده آل برای تأیید دستی یا آزمایش در مقیاس کوچکتر.
برای یادگیری نحوه استفاده از نسخه رابط کاربری گرافیکی Collection Runner، این ویدیو را برای درک تنظیمات اجرا و تجزیه و تحلیل نتایج رانر مشاهده کنید.
https://www.youtube.com/watch?v=mZvq4fMGw9Y
که وبلاگ ما را برای امروز به پایان می رساند! امیدواریم این بررسی اجمالی به شما کمک کند تا بفهمید کدام کالکشن رانر برای نیازهای شما مناسب است. ادامه دهید و هر دو نسخه را امتحان کنید و به ما بگویید کدام یک را ترجیح می دهید.
ما واقعاً از حمایت مستمر شما از Hoppscotch در طول سال‌ها سپاسگزاریم. ما در یک ماموریت هستیم تا Hoppscotch را به بهترین مجموعه برای توسعه API، آزمایش، مستندسازی و موارد دیگر تبدیل کنیم. برای اطلاع از آخرین به روز رسانی ها با Hoppscotch X و LinkedIn همراه باشید. اگر بازخورد یا پیشنهادی دارید، یک خط به آدرس hello@hoppscotch.io برای ما ارسال کنید یا در مخزن GitHub ما یک موضوع یا بحث ایجاد کنید 💚.
