ویرگول
ورودثبت نام
garmabi.mohammad73
garmabi.mohammad73Senior Software Engineer با تمرکز بر Frontend، React و TypeScript. علاقه‌مند به Software Architecture، System Design، Open Source و ساخت ابزارهای ساده و مقیاس‌پذیر.
garmabi.mohammad73
garmabi.mohammad73
خواندن ۲ دقیقه·۱ ماه پیش

انتشار tanstack-fetch 1.7.0؛ آداپترهای Solid، Angular و Svelte + دستور Doctor

در نسخه 1.7.0 کتابخانه tanstack-fetch، پشتیبانی از فریم‌ورک‌های بیشتری اضافه شده است. این نسخه شامل آداپترهای Solid، Angular و Svelte، ابزار بررسی سلامت پروژه (Doctor)، بهبود ابزار مهاجرت، نمایش پیشرفت دانلود و فیلتر فریم‌ورک در مستندات است.

اگر از TanStack Query استفاده می‌کنید، تابع queryFn باید سه اصل مهم را رعایت کند:

  1. داده را برگرداند، نه آبجکت خام Response.

  2. در صورت بروز خطا، آن را با throw اعلام کند تا وضعیت isError به‌درستی کار کند.

  3. از 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 برای بررسی سلامت پروژه

یکی از قابلیت‌های جدید این نسخه، دستور doctor است.

با اجرای این دستور، می‌توانید وضعیت استفاده از کلاینت‌های HTTP و برخی مشکلات احتمالی مهاجرت را در پروژه بررسی کنید.

برای اجرا:

npx tanstack-fetch doctor --dir ./src

این ابزار موارد زیر را بررسی می‌کند:

  • وجود پکیج‌های قدیمی مانند Axios، ky و ofetch

  • تعداد استفاده از createFetch

  • ایمپورت‌های باقی‌مانده از کتابخانه‌های قبلی

  • توابع queryFn که احتمالاً signal را به درخواست منتقل نمی‌کنند

هدف این است که پیش از تکمیل مهاجرت، مشکلات احتمالی را شناسایی کنید و بررسی کد را سریع‌تر انجام دهید.

بهبود دستور Migrate

ابزار مهاجرت حالا اسکفولدهای بیشتری برای فریم‌ورک‌های مختلف ارائه می‌دهد.

برای مهاجرت از 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

نصب یا ارتقا به نسخه 1.7.0

برای نصب نسخه جدید، دستور زیر را اجرا کنید:

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

  • صفحه npm: https://www.npmjs.com/package/tanstack-fetch

  • مخزن GitHub: https://github.com/mohamadgarmabi/tanstack-fetch

نسخه 1.7.0 با هدف گسترش پشتیبانی از فریم‌ورک‌ها، ساده‌تر کردن مهاجرت و فراهم کردن ابزارهای بهتر برای بررسی و مدیریت درخواست‌های HTTP منتشر شده است.

برنامه نویسیفرانت اندجاوا اسکریپتjavascriptاوپن سورس
۰
۰
garmabi.mohammad73
garmabi.mohammad73
Senior Software Engineer با تمرکز بر Frontend، React و TypeScript. علاقه‌مند به Software Architecture، System Design، Open Source و ساخت ابزارهای ساده و مقیاس‌پذیر.
شاید از این پست‌ها خوشتان بیاید