گزینه‌های پیش‌نمایش

مگر اینکه ذکر شده باشه، گزینه‌های این بخش فقط برای پیش‌نمایش اعمال می‌شن.

preview.host

• تایپ: string | boolean
• پیش‌فرض: server.host

مشخص می‌کنه سرور باید روی کدوم آدرس‌های IP گوش کنه. با تنظیم این روی 0.0.0.0 یا true، سرور روی همه آدرس‌ها، از جمله شبکه محلی (LAN) و آدرس‌های عمومی، گوش می‌ده.

این می‌تونه از طریق CLI با host 0.0.0.0-- یا host-- تنظیم بشه.

نکته

بعضی وقت‌ها ممکنه سرورهای دیگه به جای Vite پاسخ بدن. برای جزئیات بیشتر به server.host نگاه کنید.

preview.allowedHosts

• تایپ: string | true
• پیش‌فرض: server.allowedHosts

نام‌های میزبانی که Vite اجازه داره بهشون پاسخ بده.

برای جزئیات بیشتر به server.allowedHosts مراجعه کنید.

preview.port

• تایپ: number
• پیش‌فرض: 4173

پورت سرور رو مشخص می‌کنه. اگه پورت از قبل در حال استفاده باشه، Vite به‌طور خودکار پورت بعدی در دسترس رو امتحان می‌کنه، پس ممکنه این پورت واقعی‌ای که سرور روش گوش می‌ده نباشه.

مثال:

export default defineConfig({
  server: {
    port: 3030,
  },
  preview: {
    port: 8080,
  },
})

preview.strictPort

• تایپ: boolean
• پیش‌فرض: server.strictPort

اگه روی true تنظیم بشه، در صورتی که پورت در حال استفاده باشه، برنامه خارج می‌شه و به جای امتحان خودکار پورت بعدی، خطا می‌ده.

preview.https

• تایپ: https.ServerOptions
• پیش‌فرض: server.https

TLS و HTTP/2 رو فعال می‌کنه.

برای جزئیات بیشتر به server.https نگاه کنید.

preview.open

• تایپ: boolean | string
• پیش‌فرض: server.open

با شروع سرور، برنامه رو به‌طور خودکار توی مرورگر باز می‌کنه. اگه مقدار یه رشته باشه، به عنوان مسیر URL استفاده می‌شه. اگه می‌خواید سرور توی مرورگر خاصی که دوست دارید باز بشه، می‌تونید متغیر محیطی process.env.BROWSER رو تنظیم کنید (مثلاً firefox). همچنین می‌تونید با process.env.BROWSER_ARGS آرگومان‌های اضافی بفرستید (مثلاً incognito--).

BROWSER و BROWSER_ARGS متغیرهای محیطی خاصی هستن که می‌تونید توی فایل env. تنظیم‌شون کنید. برای جزئیات بیشتر به پکیج open مراجعه کنید.

preview.proxy

• تایپ: <Record<string, string | ProxyOptions
• پیش‌فرض: server.proxy

قوانین پراکسی سفارشی رو برای سرور پیش‌نمایش پیکربندی می‌کنه. یه آبجکت از جفت‌های ‎{ key: options } انتظار داره. اگه کلید با ^ شروع بشه، به عنوان RegExp تفسیر می‌شه. گزینه configure می‌تونه برای دسترسی به نمونه پراکسی استفاده بشه.

از http-proxy استفاده می‌کنه. گزینه‌های کامل رو اینجا ببینید.

preview.cors

• تایپ: boolean | CorsOptions
• پیش‌فرض: server.cors

CORS رو برای سرور پیش‌نمایش پیکربندی می‌کنه.

برای جزئیات بیشتر به server.cors نگاه کنید.

preview.headers

• تایپ: OutgoingHttpHeaders

هدرهای پاسخ سرور رو مشخص می‌کنه.