Skip to content

openFetch — فارسی (fa)

متن راهنما از چپ‌به‌راست (LTR) برای بلوک‌های کد حفظ شده است؛ عناوین و توضیحات فارسی را می‌توانید در مرورگر یا ویرایگر با جهت RTL بخوانید.

@hamdymohamedak/openfetch یک کلاینت HTTP سبک و بدون وابستگی برای هر محیط اجرای JavaScript است که fetch استاندارد دارد. نمونه با پیش‌فرض، قطع‌کننده‌های درخواست/پاسخ، میان‌افزار ترکیب‌پذیر، تلاش مجدد با عقب‌نشینی نمایی، حافظهٔ نهان برای GET/HEAD، خطاهای ساخت‌یافته و محافظ اختیاری URL برای ورودی غیرقابل‌اعتماد ارائه می‌دهد — بدون وابستگی به React، window یا XHR قدیمی.

اهداف طراحی

  • فقط fetch (Node 18+، Bun، Deno، Workers، مرورگر).
  • بدون polyfill اجباری در محیط‌های پشتیبانی‌شده.
  • مناسب سرور: SSR و React Server Components.

صفحات

  1. شروع سریع
  2. پیکربندی
  3. قطع‌کننده‌ها و میان‌افزار
  4. تلاش مجدد و حافظهٔ نهان
  5. خطا و امنیت

API عمومی (خلاصه)

صادراتنقش
defaultنمونهٔ از پیش ساخته‌شده با createClient()
createClient / createکلاینت جدید
OpenFetchError, isOpenFetchErrorخطای نوع‌دار
InterceptorManagerپشتهٔ قطع‌کننده
createRetryMiddlewareکارخانهٔ میان‌افزار تلاش مجدد
MemoryCacheStore, createCacheMiddleware, appendCacheKeyVaryHeadersحافظهٔ نهان
انواعOpenFetchConfig, OpenFetchResponse, …
assertSafeHttpUrlمحافظ اختیاری شبیه SSRF برای IP تحت‌اللفظ / localhost

نیازمندی

Node.js 18+ یا هر زمان‌اجرایی با fetch و AbortController.

MIT · @hamdymohamedak/openfetch