
در نسخه 1.7.0 کتابخانه tanstack-fetch، پشتیبانی از فریمورکهای بیشتری اضافه شده است. این نسخه شامل آداپترهای Solid، Angular و Svelte، ابزار بررسی سلامت پروژه (Doctor)، بهبود ابزار مهاجرت، نمایش پیشرفت دانلود و فیلتر فریمورک در مستندات است.
اگر از TanStack Query استفاده میکنید، تابع queryFn باید سه اصل مهم را رعایت کند:
داده را برگرداند، نه آبجکت خام Response.
در صورت بروز خطا، آن را با throw اعلام کند تا وضعیت isError بهدرستی کار کند.
از AbortSignal پشتیبانی کند تا درخواستها در صورت نیاز لغو شوند.
tanstack-fetch با همین رویکرد طراحی شده است: سادهسازی لایه HTTP و هماهنگی بهتر آن با الگوی استفاده از TanStack Query.
توجه: tanstack-fetch یک پروژه مستقل و غیررسمی است و ارتباطی با تیم رسمی TanStack ندارد.
در نسخه 1.7.0، آداپترهای Solid، Svelte و Angular اضافه شدهاند تا بتوان از قابلیتهای کتابخانه در این فریمورکها استفاده کرد.
Solid
مسیر ایمپورت:
tanstack-fetch/solid
APIهای اصلی:
FetchProvider
useFetch
useSse
Svelte
مسیر ایمپورت:
tanstack-fetch/svelte
APIهای اصلی:
setFetchClient
useFetch
useSse
Angular
مسیر ایمپورت:
tanstack-fetch/angular
APIهای اصلی:
provideFetchClient
injectFetch
useSse
مدیریت وضعیت اتصال SSE نیز از یک الگوی یکسان پیروی میکند:
connecting، connected، disconnected و error
این وضعیتها کمک میکنند شرایط اتصال و خطاهای ارتباطی را در برنامه بهتر مدیریت کنید.
مستندات آداپتر Solid:
https://mohamadgarmabi.github.io/tanstack-fetch/guide/solid
یکی از قابلیتهای جدید این نسخه، دستور doctor است.
با اجرای این دستور، میتوانید وضعیت استفاده از کلاینتهای HTTP و برخی مشکلات احتمالی مهاجرت را در پروژه بررسی کنید.
برای اجرا:
npx tanstack-fetch doctor --dir ./src
این ابزار موارد زیر را بررسی میکند:
وجود پکیجهای قدیمی مانند Axios، ky و ofetch
تعداد استفاده از createFetch
ایمپورتهای باقیمانده از کتابخانههای قبلی
توابع queryFn که احتمالاً signal را به درخواست منتقل نمیکنند
هدف این است که پیش از تکمیل مهاجرت، مشکلات احتمالی را شناسایی کنید و بررسی کد را سریعتر انجام دهید.
ابزار مهاجرت حالا اسکفولدهای بیشتری برای فریمورکهای مختلف ارائه میدهد.
برای مهاجرت از Axios به Solid:
npx tanstack-fetch migrate --from axios --framework solid --write
برای مهاجرت از Axios به Angular:
npx tanstack-fetch migrate --from axios --framework angular --write
برای مهاجرت از Fetch به Svelte:
npx tanstack-fetch migrate --from fetch --framework svelte --write
برای مهاجرت از Fetch به SvelteKit:
npx tanstack-fetch migrate --from fetch --framework sveltekit --write
این دستورها با هدف کمک به شروع مهاجرت و ایجاد ساختار مناسب برای فریمورک مقصد ارائه شدهاند. بعد از اجرا، کد تولیدشده را بررسی کنید و بخشهایی را که به منطق اختصاصی پروژه وابستهاند، بهصورت دستی اصلاح کنید.
راهنمای مهاجرت:
https://mohamadgarmabi.github.io/tanstack-fetch/guide/migrate
قابلیت جدید onDownloadProgress امکان مشاهده پیشرفت دانلود را فراهم میکند.
برای مثال، هنگام دانلود یک فایل PDF:
await api.get('/files/report.pdf', { parseAs: 'blob', onDownloadProgress: ({ progress, loaded, total }) => { console.log(progress, loaded, total) }, })
در این مثال:
progress میزان پیشرفت دانلود را نشان میدهد.
loaded حجم دریافتشده را مشخص میکند.
total حجم کل فایل را، در صورت در دسترس بودن، نشان میدهد.
این قابلیت برای نمایش نوار پیشرفت دانلود فایلها و بهبود تجربه کاربری مفید است.
راهنمای آپلود و دانلود:
https://mohamadgarmabi.github.io/tanstack-fetch/guide/upload
برای نصب نسخه جدید، دستور زیر را اجرا کنید:
npm install [email protected]
وبلاگ نسخه 1.7.0: https://mohamadgarmabi.github.io/tanstack-fetch/blog/tanstack-fetch-1-7-0
راهنمای مهاجرت: https://mohamadgarmabi.github.io/tanstack-fetch/guide/migrate
راهنمای آپلود و دانلود: https://mohamadgarmabi.github.io/tanstack-fetch/guide/upload
مستندات Solid: https://mohamadgarmabi.github.io/tanstack-fetch/guide/solid
مخزن GitHub: https://github.com/mohamadgarmabi/tanstack-fetch
نسخه 1.7.0 با هدف گسترش پشتیبانی از فریمورکها، سادهتر کردن مهاجرت و فراهم کردن ابزارهای بهتر برای بررسی و مدیریت درخواستهای HTTP منتشر شده است.