Import کردن متغیرهای محیط با افزونه Postman برای VS Code

افزونه Postman برای VS Code می‌تواند فایل‌های .env پروژه API شما را به Environmentهای Postman تبدیل کند. با این روش، متغیرها را در پروژه نگه می‌دارید و هر زمان آماده تست بودید، آن‌ها را با Postman sync می‌کنید.

قبل از import

مطمئن شوید پروژه شما حداقل یک فایل با پسوند .env دارد و متغیرها داخل آن به‌صورت key-value ذخیره شده‌اند؛ مثلا API_URL=http://localhost:3000.

Import چند فایل .env

1. پروژه API را در VS Code باز کنید. افزونه Postman فایل‌های .env جدیدی را که هنوز import نشده‌اند بررسی می‌کند.
2. اگر اعلان داخل برنامه نمایش داده شد، روی Import Now کلیک کنید. همچنین می‌توانید از بالای sidebar روی Import بزنید و گزینه .env files را انتخاب کنید.
3. در تب Import Environments فایل‌های پیدا شده را بررسی کنید. برای پیدا کردن فایل مشخص، از کادر Search by name استفاده کنید.
4. در صورت نیاز، کنار فایل روی Edit بزنید و نام Environment، متغیرها، نوع variable، مقدارهای current و initial، و گزینه‌های Persist یا Reset را تنظیم کنید.
5. فایل‌هایی را که می‌خواهید وارد شوند انتخاب کنید. هر فایل .env به یک Environment جداگانه در Postman تبدیل می‌شود.
6. روی Import کلیک کنید.

Import یک فایل .env

1. پروژه API را در VS Code باز کنید.
2. فایل .env موردنظر را باز کنید و از بالای فایل روی Import to Postman کلیک کنید. همچنین می‌توانید روی فایل راست‌کلیک کنید و Import / Open in Postman را انتخاب کنید.
3. Environment جدید در Postman باز می‌شود و متغیرهای فایل داخل آن قرار می‌گیرند.
4. اگر تغییری در Environment دادید، روی Save کلیک کنید.

در import تک‌فایل، قبل از import امکان ویرایش متغیرها وجود ندارد، اما بعد از import می‌توانید نوع و مقدار variableها را تغییر دهید.

کار با فایل‌های import شده

بعد از import، اگر همان فایل .env را در پروژه باز کنید، می‌توانید با گزینه Open in Postman Environment مرتبط را باز کنید. اگر Environment به Workspace دیگری منتقل شده باشد، افزونه در صورت داشتن دسترسی همان Environment منتقل‌شده را باز می‌کند.

Sync تغییرات

وقتی فایل .env import شده را تغییر می‌دهید، می‌توانید تغییرات را با Environment مربوط در Postman sync کنید. برای sync:

1. پروژه API را در VS Code باز کنید.
2. فایل .env import شده را تغییر دهید.
3. از اعلان داخل برنامه روی Sync Now کلیک کنید، یا از بالای فایل Sync to Postman را بزنید، یا روی فایل راست‌کلیک کنید و همین گزینه را انتخاب کنید.
4. این کار را برای هر فایل .env تغییرکرده تکرار کنید.

هنگام sync، مقدارهای current و initial در Environment به‌روزرسانی می‌شوند. مقدار initial با Postman cloud sync می‌شود و در صورت share شدن Environment، برای تیم قابل استفاده خواهد بود.

منبع آموزشی: Postman Docs، بازنویسی و ساده‌سازی‌شده برای کاربران فارسی‌زبان.