في Bun، يدعم fetch إرسال الطلبات عبر وكيل HTTP أو HTTPS. هذا مفيد في شبكات الشركات أو عندما تحتاج إلى التأكد من إرسال الطلب عبر عنوان IP محدد.

await fetch("https://example.com", {
  // عنوان URL لخادم الوكيل
  proxy: "https://username:password@proxy.example.com:8080",
});

---

يمكن أن يكون خيار proxy سلسلة URL أو كائن يحتوي على url و headers اختيارية. يمكن أن يتضمن URL اسم المستخدم وكلمة المرور إذا كان الوكيل يتطلب مصادقة. يمكن أن يكون http:// أو https://.

---

رؤوس وكيل مخصصة

لإرسال رؤوس مخصصة إلى خادم الوكيل (مفيد لرموز مصادقة الوكيل، أو التوجيه المخصص، إلخ)، استخدم تنسيق الكائن:

await fetch("https://example.com", {
  proxy: {
    url: "https://proxy.example.com:8080",
    headers: {
      "Proxy-Authorization": "Bearer my-token",
      "X-Proxy-Region": "us-east-1",
    },
  },
});

يقبل خاصية headers كائنًا عاديًا أو مثيل Headers. يتم إرسال هذه الرؤوس مباشرة إلى خادم الوكيل في طلبات CONNECT (للأهداف HTTPS) أو في طلب الوكيل (للأهداف HTTP).

إذا قدمت رأس Proxy-Authorization، فسيتم تجاوز أي بيانات اعتماد محددة في عنوان URL للوكيل.

---

متغيرات البيئة

يمكنك أيضًا تعيين متغير البيئة $HTTP_PROXY أو $HTTPS_PROXY إلى عنوان URL للوكيل. هذا مفيد عندما تريد استخدام نفس الوكيل لجميع الطلبات.

HTTPS_PROXY=https://username:password@proxy.example.com:8080 bun run index.ts