با Collection Runner در افزونه Postman برای VS Code می‌توانید درخواست‌های یک Collection یا folder را به‌ترتیب مشخص اجرا کنید. این قابلیت برای تست عملکرد API، اجرای چند درخواست وابسته و دیدن نتیجه تست‌ها مناسب است. برای اجرای خودکار در CI/CD، معمولا Postman CLI گزینه مناسب‌تری است.
پیکربندی اجرای Collection
- Collection یا folder شامل درخواست‌هایی را که می‌خواهید پشت سر هم اجرا شوند انتخاب کنید.
- روی Run کلیک کنید تا تنظیمات اجرای Collection باز شود.
- اگر اجرای Collection به Environment نیاز دارد، از environment selector در بالا سمت راست آن را انتخاب کنید. همچنین می‌توانید Environment جدید بسازید.
- گزینه‌های اجرای Collection، مثل iteration و داده‌های ورودی، را تنظیم کنید.
- روی Run (collection name) کلیک کنید.
پلن Postman شما تعداد مشخصی Collection run در ماه دارد. اجرای چند iteration از یک Collection به‌عنوان یک run شمرده می‌شود.
عیب‌یابی نتیجه run
هنگام اجرای دستی Collection، Postman نتیجه درخواست‌ها و تست‌ها را real-time نمایش می‌دهد. برای بررسی جزئیات می‌توانید:
- یک request را انتخاب کنید و response، headerها و request اصلی را ببینید.
- روی نام request کلیک کنید تا در یک تب جدید باز شود.
- با تب‌های Passed، Failed و Skipped نتیجه‌ها را فیلتر کنید.
- برای نمایش همه درخواست‌ها، تب All Tests را انتخاب کنید.
- اگر تستی در script یک request fail شود، کل آن request در run شکست‌خورده محسوب می‌شود.
- با Run Again اجرای قبلی را با همان تنظیمات تکرار کنید یا با New Run تنظیمات جدید بسازید.
دیدن تاریخچه runها
وقتی یک Collection را با Collection Runner یا Postman CLI اجرا می‌کنید، نتیجه در run history ذخیره می‌شود. برای دیدن آن، Collection را انتخاب کنید و تب Runs را باز کنید.
در run history می‌توانید تاریخ و زمان اجرا، منبع اجرا، مدت اجرا، تعداد تست‌های passed/failed/skipped و میانگین زمان پاسخ را ببینید. همچنین فیلترهایی مثل Last، Run by، Run status و Source برای محدود کردن نتیجه‌ها وجود دارد.
گزارش اجرای Collection
برای دیدن جزئیات یک اجرای خاص، روی Collection run کلیک کنید. همچنین می‌توانید روی View Report بزنید تا گزارش نتیجه اجرا را باز کنید.
منبع آموزشی: Postman Docs، بازنویسی و ساده‌سازی‌شده برای کاربران فارسی‌زبان.