پرش به محتوا

کتابخانه

دانلود workbox-cdn و نشانی CDN ایرانی

workbox-cdn یه بسته آماده از کتابخونه Workbox گوگله که بدون ابزار build و فقط با بارگذاری یه اسکریپت می تونی توی سایتت استفاده کنی. با Workbox سرویس ورکر رو راحت تر می نویسی، کش و حالت آفلاین رو مدیریت می کنی و بازدیدهای بعدی سایتت سریع تر باز می شن.

نسخه رسمی و بدون تغییر، از منبع رسمی با مجوز MIT؛ هش هر فایل با منبع بررسی شده است.

آخرین نسخه
۵.۱.۴
نسخه‌ها در مخزن
۳
مجوز
MIT
سازنده
Google's Web DevRel Team
آخرین بررسی
آخرین به‌روزرسانی
توضیحات

آخرین نسخه

آخرین نسخه ۵.۱.۴ آخرین

۴۱۶ کیلوبایت· ۳۳ فایل· انتشار

دانلود
نشانی مستقیم فایل اصلی https://mirror.wbweb.ir/npm/workbox-cdn@5.1.4/workbox/workbox-window.dev.umd.js
کد آماده با SRI <script src="https://mirror.wbweb.ir/npm/workbox-cdn@5.1.4/workbox/workbox-window.dev.umd.js" integrity="sha256-mTGSb1RhAnvP1uulPbUBUkMwRSZyAg07LYpgCR9bUgc=" crossorigin="anonymous"></script>

SHA-256: 9931926f5461027bcfd6eba53db501524330452672020d3b2d8a60091f5b5207

درباره workbox-cdn (ورک باکس سی دی ان)

Workbox مجموعه ای از ماژول های جاوااسکریپته که نوشتن سرویس ورکر رو ساده می کنه. اگه خودت دستی سرویس ورکر نوشته باشی، می دونی چقدر دردسر داره: کش کردن فایل ها، تصمیم گرفتن اینکه چی از کش بیاد و چی از شبکه، پاک کردن کش قدیمی. Workbox این کارها رو با چند خط تنظیم انجام می ده. workbox-cdn همین کتابخونه رو به شکل فایل های آماده در اختیارت می ذاره. بدون Webpack و ابزار build و فقط با بارگذاری یه اسکریپت می تونی ازش استفاده کنی. خود منبع هم اسمش رو «Workbox Unofficial CDN» گذاشته، یعنی بسته ای غیررسمی برای دسترسی از مسیر CDN.

کاربرد اصلیش اینه که سایتت توی اینترنت ضعیف بهتر رفتار کنه. فرض کن یه سایت وردپرسی شرکتی یا مجله ای داری و بیشتر بازدیدکننده هات با موبایل و اینترنت ناپایدار میان. اگه CSS، جاوااسکریپت، فونت و تصویرهای ثابت کش بشن، بازدید دوم و سوم خیلی سریع تر باز می شه. می تونی یه صفحه آفلاین ساده هم بذاری تا وقتی نت قطع شد، کاربر به جای خطای مرورگر یه پیام درست و با ظاهر سایت خودت ببینه. برای ساخت یه PWA ساده هم نقطه شروع خوبیه.

ولی همه جا مناسب نیست. اگه پروژه ات با bundler ساخته می شه، بهتره ماژول های Workbox رو مستقیم نصب کنی و فقط بخش های لازم رو وارد بیلد کنی. سایت هایی که محتوای پویا زیاد دارن، مثل فروشگاه با سبد خرید، پنل کاربری یا داشبورد، باید با احتیاط بیشتری کش بشن. کش اشتباه یعنی کاربر قیمت یا صفحه قدیمی می بینه. صفحه های مدیریت و درخواست های ورود و پرداخت رو اصلا کش نکن. یادت باشه سرویس ورکر فقط روی HTTPS کار می کنه، و برای تست روی localhost.

موقع استفاده، نسخه رو ثابت نگه دار و قبل از هر تغییر، اول روی یه نسخه تستی امتحانش کن. استراتژی کش رو هم برای هر نوع فایل جدا انتخاب کن، نه یه قانون واحد برای کل سایت. فایل های اصلی و بدون تغییر workbox-cdn توی مخزن داخلی ما هم هست. پس اگه دسترسی به اینترنت بین الملل محدود بود، می تونی از همین جا بگیری و روی هاست خودت بذاری تا سایتت به سرویس خارجی وابسته نباشه.

راهنمای استفاده

کار با workbox-cdn توی چند قدم جمع می شه. چون سرویس ورکر یه فایل جداست، ترتیب کارها مهمه:

  • فایل های کتابخونه رو با کد آماده پایین همین صفحه اضافه کن. اگه نمی خوای به منبع بیرونی وابسته باشی، فایل ها رو از همین مخزن بگیر و روی هاست خودت بذار.
  • یه فایل سرویس ورکر بساز، مثلا با اسم sw.js، و توی ریشه سایت بذارش تا کل سایت رو پوشش بده. اگه توی یه پوشه عمیق باشه، فقط همون مسیر رو کنترل می کنه.
  • اول همین فایل، با importScripts اسکریپت Workbox رو بارگذاری کن.
  • برای هر نوع فایل یه استراتژی جدا بذار. معمولا CacheFirst برای تصویر و فونت، StaleWhileRevalidate برای CSS و جاوااسکریپت و NetworkFirst برای صفحه های HTML جواب می ده.
  • توی قالب یا صفحه، سرویس ورکر رو با navigator.serviceWorker.register ثبت کن.
  • سایت رو روی HTTPS بالا بیار و توی DevTools مرورگر، بخش Application و بعد Service Workers رو چک کن.
  • حالت Offline رو روشن کن و ببین صفحه ها و فایل های کش شده درست بالا میان یا نه.

اگه چیزی رو عوض کردی و نتیجه اش رو نمی بینی، قبل از هر کاری گزینه Update on reload رو توی DevTools روشن کن.

همه نسخه‌ها (۳)

نسخه‌های ۵.x ۲ نسخه
  • ۵.۱.۴ آخرین نسخه ۴۱۶ کیلوبایت·
    دانلودنسخه 5.1.4
    نشانی مستقیم فایل اصلی 5.1.4 https://mirror.wbweb.ir/npm/workbox-cdn@5.1.4/workbox/workbox-window.dev.umd.js
  • ۵.۱.۳ ۴۱۳ کیلوبایت·
    دانلودنسخه 5.1.3
    نشانی مستقیم فایل اصلی 5.1.3 https://mirror.wbweb.ir/npm/workbox-cdn@5.1.3/workbox/workbox-window.dev.umd.js
نسخه‌های ۴.x ۱ نسخه
  • ۴.۳.۱ قدیمی‌ترین نسخه ۳۶۸ کیلوبایت·
    دانلودنسخه 4.3.1
    نشانی مستقیم فایل اصلی 4.3.1 https://mirror.wbweb.ir/npm/workbox-cdn@4.3.1/workbox/workbox-window.dev.umd.js

پرسش‌های رایج

  • workbox-cdn همون کتابخونه Workbox رو به شکل فایل های آماده برای بارگذاری مستقیم عرضه می کنه، پس لازم نیست پروژه رو با ابزار build بسازی. خود منبع اسمش رو نسخه غیررسمی CDN گذاشته. قابلیت های اصلی همون Workbox برای نوشتن سرویس ورکر و کش کردنه.

  • بله. مرورگرها سرویس ورکر رو فقط روی اتصال امن قبول می کنن. تنها استثنا localhost برای تست روی سیستم خودته. اگه سایتت هنوز گواهی SSL نداره، اول اون رو فعال کن و بعد سراغ Workbox برو، وگرنه ثبت سرویس ورکر خطا می ده.

  • می شه، ولی خودکار نیست. باید فایل سرویس ورکر رو توی ریشه سایت بذاری و توی قالب ثبتش کنی. حواست باشه صفحه های مدیریت، ورود، سبد خرید و پرداخت کش نشن، چون کش اشتباه باعث می شه کاربر اطلاعات قدیمی ببینه.

  • سرویس ورکر جدید معمولا تا وقتی همه تب های قبلی بسته نشن فعال نمی شه، و کش قدیمی هم تا منقضی یا پاک نشه سرجاشه. موقع تست، توی DevTools گزینه Update on reload رو بزن. برای کاربرهای واقعی هم استراتژی مناسب و نسخه بندی فایل ها کمک می کنه.

چیزی که لازم دارید اینجا نیست؟

نام کتابخانه، افزونه یا قالب را بفرستید؛ پس از بررسی، نسخه‌های رسمی آن به مخزن اضافه می‌شود.