واحدهای ES در عاملان خدماتی

جایگزینی مدرن برای importScripts().

پس‌زمینه

مدول‌های ES مدتی است که موردعلاقه توسعه‌دهندگان است. علاوه‌بر تعدادی مزایای دیگر، آن‌ها نوید یک قالب واحد جهانی را می‌دهند که در آن کد مشترک می‌تواند یک‌بار منتشر شود و در مرورگرها و در زمان‌های اجرای جایگزین مانند Node.js اجرا شود. درحالی‌که همه مرورگرهای مدرن تاحدی از ماژول ES پشتیبانی می‌کنند، همه آن‌ها در هر جایی که کد می‌تواند اجرا شود پشتیبانی ارائه نمی‌دهند. به‌طور خاص، پشتیبانی از وارد کردن ماژول‌های ES در سرویس‌ورکر مرورگر تازه دارد به‌طور گسترده‌تری دردسترس قرار می‌گیرد.

This article details the current state of ES module support in service workers across common browsers, along with some gotchas to avoid, and best practices for shipping backwards-compatible service worker code.

موارد استفاده

The ideal use case for ES modules inside of service workers is for loading a modern library or configuration code that's shared with other runtimes that support ES modules.

تلاش برای هم‌رسانی کد به این روش قبل‌از ماژول‌های ES مستلزم استفاده از قالب‌های ماژول «جهانی» قدیمی‌تر مانند UMD بود که شامل کدهای تکراری غیرضروری بودند و نوشتن کدی که تغییراتی در متغیرهای درمعرض دید جهانی ایجاد می‌کرد.

اسکریپت‌های واردشده ازطریق ماژول‌های ES می‌توانند درصورت تغییر محتوایشان، جریان به‌روزرسانی سرویس‌ورکر را راه‌اندازی کنند که با رفتار importScripts() مطابقت دارد.

محدودیت‌های فعلی

فقط واردات ایستا

ماژول‌های ES را می‌توان به یکی از دو روش وارد کرد: ایستا، بااستفاده از نحو import ... from '...'، یا پویا، بااستفاده از روش import(). در داخل یک سرویس‌ورکر، درحال‌حاضر فقط نحو ایستا پشتیبانی می‌شود.

این محدودیت مشابه محدودیت مشابهی است که بر استفاده از importScripts() اعمال شده است. فراخوانی‌های پویا به importScripts() در داخل یک سرویس‌کار کار نمی‌کنند و همه فراخوانی‌های importScripts() که ذاتاً همگام هستند باید قبل‌از اینکه سرویس‌کار فاز install خود را تکمیل کند، تکمیل شوند. این محدودیت تضمین می‌کند که مرورگر از همه کدهای جاوا اسکریپت موردنیاز برای پیاده‌سازی سرویس‌کار درطول نصب مطلع است و می‌تواند آن‌ها را به‌طور ضمنی ذخیره کند.

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

کارگران دیگر چطور؟

پشتیبانی از ماژول‌های ES در کارگران «اختصاصی»—آن‌هایی که با new Worker('...', {type: 'module'}) ساخته شده‌اند—گسترده‌تر است و از نسخه ۸۰ در Chrome و Edge و همچنین نسخه‌های اخیر Safari پشتیبانی می‌شود. هر دو واردات ماژول ES ایستا و پویا در کارگران اختصاصی پشتیبانی می‌شوند.

Chrome و Edge از ماژول‌های ES در کارگران مشترک از نسخه ۸۳ پشتیبانی کرده‌اند، اما هیچ مرورگر دیگری درحال‌حاضر پشتیبانی ارائه نمی‌دهد.

از نقشه‌های واردشده پشتیبانی نمی‌شود

نقشه‌های واردات به محیط‌های زمان اجرا اجازه می‌دهند تا مشخص‌کننده‌های ماژول را بازنویسی کنند، برای مثال، نشانی وب یک CDN ترجیحی را که ماژول‌های ES می‌توانند از آن بارگیری شوند، پیشوند کنند.

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

پشتیبانی مرورگر

ماژول‌های ES در کارگران خدمات در Chrome و Edge از نسخه ۹۱ پشتیبانی می‌شوند.

Safari در نسخه Technology Preview 122 پشتیبانی اضافه کرد، و توسعه‌دهندگان باید انتظار داشته باشند که این عملکرد در آینده در نسخه پایدار Safari منتشر شود.

کد نمونه

این نمونه‌ای ساده از استفاده از واحد ES هم‌رسانی‌شده در بافت window برنامه وب است، درحالی‌که یک سرویس‌کار را نیز ثبت می‌کند که از همان واحد ES استفاده می‌کند:

// Inside config.js:
export const cacheName = 'my-cache';
// Inside your web app:
<script type="module">
  import {cacheName} from './config.js';
  // Do something with cacheName.

  await navigator.serviceWorker.register('es-module-sw.js', {
    type: 'module',
  });
</script>
// Inside es-module-sw.js:
import {cacheName} from './config.js';

self.addEventListener('install', (event) => {
  event.waitUntil((async () => {
    const cache = await caches.open(cacheName);
    // ...
  })());
});

سازگاری با نسخه قدیمی

اگر همه مرورگرها از ماژول‌های ES در عامل‌های خدماتی پشتیبانی می‌کردند، مثال بالا به‌خوبی کار می‌کرد، اما در زمان نوشتن این مطلب، این‌طور نیست.

برای تطبیق مرورگرهایی که پشتیبانی داخلی ندارند، می‌توانید اسکریپت سرویس‌کار خود را ازطریق یک بسته‌ساز سازگار با ماژول ES اجرا کنید تا یک سرویس‌کار ایجاد کنید که شامل تمام کدهای ماژول به‌صورت درون‌خطی باشد و در مرورگرهای قدیمی‌تر کار کند. یا اگر ماژول‌هایی که می‌خواهید وارد کنید قبلاً به‌صورت بسته‌بندی‌شده در قالب‌های IIFE یا UMD دردسترس هستند، می‌توانید آن‌ها را بااستفاده از importScripts() وارد کنید.

Once you have two versions of your service worker available—one that uses ES modules, and the other that doesn't—you'll need to detect what the current browser supports, and register the corresponding service worker script. روال‌های مطلوب برای تشخیص پشتیبانی درحال‌حاضر درحال تغییر است، اما می‌توانید بحث را در این مشکل GitHub برای توصیه‌ها دنبال کنید.