کتابخانه Postman Runtime یک پروژه متن‌باز Node.js است که برای اجرای درخواست‌ها و Collectionها در سطح پایین‌تر استفاده می‌شود. این کتابخانه همان ایده اجرای درخواست و Collection را به شکل قابل‌استفاده در ابزارهای برنامه‌نویسی، تست خودکار و pipelineهای توسعه در اختیار شما می‌گذارد.
کاربرد اصلی Runtime
- اجرای Collection با تنظیمات دقیق‌تر نسبت به اجرای ساده.
- کنترل timeout درخواست‌ها و اسکریپت‌ها.
- ادغام اجرای Collection در ابزارهای Node.js یا فرآیندهای CI/CD.
- استفاده همراه با Collection SDK برای ساخت Collection و سپس اجرای آن.
دسترسی و نصب
برای شروع، README مخزن رسمی بهترین نقطه ورود است. کتابخانه از npm هم قابل نصب است:
نمونه استفاده همراه با Collection SDK
در این نمونه، یک Runner ساخته می‌شود، یک Collection به آن داده می‌شود و تنظیماتی مانند timeout و تعداد iteration مشخص می‌شود:
runtime = require('postman-runtime');
var runner = new runtime.Runner();
// Collection object constructed using the Collection SDK
var collection = new sdk.Collection();
runner.run(collection, {
data: [],
timeout: {
request: 30000,
script: 5000
},
iterationCount: 1,
//other options...
},
function (err, run) {
// Callbacks to run as the collection runs
run.start(callbacks);
});
انتخاب بین Runtime و Postman CLI
اگر فقط می‌خواهید Collectionها را اجرا کنید، Postman CLI معمولا گزینه ساده‌تر و آماده‌تری است. Runtime زمانی ارزشمندتر است که اجرای درخواست‌ها بخشی از یک ابزار Node.js سفارشی باشد یا به کنترل دقیق‌تری روی تنظیمات اجرا نیاز داشته باشید.
گام بعدی
برای workflowهای CI/CD، Runtime می‌تواند کنار Collection SDK و Postman CLI استفاده شود؛ SDK برای ساخت یا تغییر Collection، Runtime برای کنترل اجرای برنامه‌نویسی‌شده، و CLI برای اجرای آماده در خط فرمان.
منبع آموزشی: Postman Docs، بازنویسی و ساده‌سازی‌شده برای کاربران فارسی‌زبان.