Closed2

create-react-app service worker 更新タイミングまとめ

ハトすけハトすけ

create-react-appでservice workerを作成した。preload cacheもうまく動く。ただ、ホスティングサービスでアップデートがあっても service-workerのアップデートが走らない。タブを閉じて開き直すか、ハードリロードしなければupdateされない。

service-worker.ts
/// <reference lib="webworker" />

/* eslint-disable no-restricted-globals */
// This service worker can be customized!
// See https://developers.google.com/web/tools/workbox/modules
// for the list of available Workbox modules, or add any other
// code you'd like.
// You can also remove this file if you'd prefer not to use a
// service worker, and the Workbox build step will be skipped.
import { clientsClaim } from 'workbox-core';
import { ExpirationPlugin } from 'workbox-expiration';
import { precacheAndRoute, createHandlerBoundToURL } from 'workbox-precaching';
import { registerRoute } from 'workbox-routing';
import { StaleWhileRevalidate } from 'workbox-strategies';

declare const self: ServiceWorkerGlobalScope;

clientsClaim();

// Precache all of the assets generated by your build process.
// Their URLs are injected into the manifest variable below.
// This variable must be present somewhere in your service worker file,
// even if you decide not to use precaching. See https://cra.link/PWA
// eslint-disable-next-line no-underscore-dangle
precacheAndRoute(self.__WB_MANIFEST);

// Set up App Shell-style routing, so that all navigation requests
// are fulfilled with your index.html shell. Learn more at
// https://developers.google.com/web/fundamentals/architecture/app-shell
const fileExtensionRegexp = new RegExp('/[^/?]+\\.[^/]+$');
registerRoute(
  // Return false to exempt requests from being fulfilled by index.html.
  ({ request, url }: { request: Request; url: URL }) => {
    // If this isn't a navigation, skip.
    if (request.mode !== 'navigate') {
      return false;
    }

    // If this is a URL that starts with /_, skip.
    if (url.pathname.startsWith('/_')) {
      return false;
    }

    // If this looks like a URL for a resource, because it contains
    // a file extension, skip.
    if (url.pathname.match(fileExtensionRegexp)) {
      return false;
    }

    // Return true to signal that we want to use the handler.
    return true;
  },
  createHandlerBoundToURL(`${process.env.PUBLIC_URL}/index.html`),
);

// An example runtime caching route for requests that aren't handled by the
// precache, in this case same-origin .png requests like those from in public/
registerRoute(
  // Add in any other file extensions or routing criteria as needed.
  ({ url }) =>
    url.origin === self.location.origin && url.pathname.endsWith('.png'),
  // Customize this strategy as needed, e.g., by changing to CacheFirst.
  new StaleWhileRevalidate({
    cacheName: 'images',
    plugins: [
      // Ensure that once this runtime cache reaches a maximum size the
      // least-recently used images are removed.
      new ExpirationPlugin({ maxEntries: 50 }),
    ],
  }),
);

// This allows the web app to trigger skipWaiting via
// registration.waiting.postMessage({type: 'SKIP_WAITING'})
self.addEventListener('message', (event) => {
  if (event.data && event.data.type === 'SKIP_WAITING') {
    self.skipWaiting();
  }
});

// Any other custom service worker logic can go here.

serviceWorkerRegistration.ts
// This optional code is used to register a service worker.
// register() is not called by default.
// This lets the app load faster on subsequent visits in production, and gives
// it offline capabilities. However, it also means that developers (and users)
// will only see deployed updates on subsequent visits to a page, after all the
// existing tabs open on the page have been closed, since previously cached
// resources are updated in the background.
// To learn more about the benefits of this model and instructions on how to
// opt-in, read https://bit.ly/CRA-PWA

/* eslint func-style: 'off' */

/* eslint no-param-reassign: 'off' */

/* eslint no-use-before-define: 'off' */

const isLocalhost = Boolean(
  window.location.hostname === 'localhost' ||
    // [::1] is the IPv6 localhost address.
    window.location.hostname === '[::1]' ||
    // 127.0.0.0/8 are considered localhost for IPv4.
    window.location.hostname.match(
      /^127(?:\.(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)){3}$/,
    ),
);

type Config = {
  onSuccess?: (registration: ServiceWorkerRegistration) => void;
  onUpdate?: (registration: ServiceWorkerRegistration) => void;
};

export function register(config?: Config): void {
  if (process.env.NODE_ENV === 'production' && 'serviceWorker' in navigator) {
    // The URL constructor is available in all browsers that support SW.
    const publicUrl = new URL(process.env.PUBLIC_URL, window.location.href);
    if (publicUrl.origin !== window.location.origin) {
      // Our service worker won't work if PUBLIC_URL is on a different origin
      // from what our page is served on. This might happen if a CDN is used to
      // serve assets; see https://github.com/facebook/create-react-app/issues/2374
      return;
    }

    window.addEventListener('load', () => {
      const swUrl = `${process.env.PUBLIC_URL}/service-worker.js`;

      if (isLocalhost) {
        // This is running on localhost. Let's check if a service worker still exists or not.
        checkValidServiceWorker(swUrl, config);

        // Add some additional logging to localhost, pointing developers to the
        // service worker/PWA documentation.
        navigator.serviceWorker.ready.then(() => {
          console.log(
            'This web app is being served cache-first by a service ' +
              'worker. To learn more, visit https://bit.ly/CRA-PWA',
          );
        });
      } else {
        // Is not localhost. Just register service worker
        registerValidSW(swUrl, config);
      }
    });
  }
}

function registerValidSW(swUrl: string, config?: Config) {
  navigator.serviceWorker
    .register(swUrl)
    .then((registration) => {
      registration.onupdatefound = () => {
        const installingWorker = registration.installing;
        if (installingWorker == null) {
          return;
        }
        installingWorker.onstatechange = () => {
          if (installingWorker.state === 'installed') {
            if (navigator.serviceWorker.controller) {
              // At this point, the updated precached content has been fetched,
              // but the previous service worker will still serve the older
              // content until all client tabs are closed.
              console.log(
                'New content is available and will be used when all ' +
                  'tabs for this page are closed. See https://bit.ly/CRA-PWA.',
              );

              // Execute callback
              if (config && config.onUpdate) {
                config.onUpdate(registration);
              }
            } else {
              // At this point, everything has been precached.
              // It's the perfect time to display a
              // "Content is cached for offline use." message.
              console.log('Content is cached for offline use.');

              // Execute callback
              if (config && config.onSuccess) {
                config.onSuccess(registration);
              }
            }
          }
        };
      };
    })
    .catch((error) => {
      console.error('Error during service worker registration:', error);
    });
}

function checkValidServiceWorker(swUrl: string, config?: Config) {
  // Check if the service worker can be found. If it can't reload the page.
  fetch(swUrl, {
    headers: { 'Service-Worker': 'script' },
  })
    .then((response) => {
      // Ensure service worker exists, and that we really are getting a JS file.
      const contentType = response.headers.get('content-type');
      if (
        response.status === 404 ||
        (contentType != null && contentType.indexOf('javascript') === -1)
      ) {
        // No service worker found. Probably a different app. Reload the page.
        navigator.serviceWorker.ready.then((registration) => {
          registration.unregister().then(() => {
            window.location.reload();
          });
        });
      } else {
        // Service worker found. Proceed as normal.
        registerValidSW(swUrl, config);
      }
    })
    .catch(() => {
      console.log(
        'No internet connection found. App is running in offline mode.',
      );
    });
}

export function unregister(): void {
  if ('serviceWorker' in navigator) {
    navigator.serviceWorker.ready
      .then((registration) => {
        registration.unregister();
      })
      .catch((error) => {
        console.error(error.message);
      });
  }
}

index.ts
import React from 'react';
import ReactDOM from 'react-dom';

import App from './App';
import './index.css';
import * as serviceWorkerRegistration from './serviceWorkerRegistration';

ReactDOM.render(<App />, document.getElementById('root'));

const configuration = {
  onUpdate: (registration: ServiceWorkerRegistration) => {
    if (registration && registration.waiting) {
      if (
        // eslint-disable-next-line no-alert
        window.confirm(
          'アプリが更新されました。新しいバージョンへ移行するため、ページをリロードしてもよろしいですか?',
        )
      ) {
        registration.waiting.postMessage({ type: 'SKIP_WAITING' });
        window.location.reload();
      }
    }
  },
};

// If you want your app to work offline and load faster, you can change
// unregister() to register() below. Note this comes with some pitfalls.
// Learn more about service workers: https://cra.link/PWA
serviceWorkerRegistration.register(configuration);

package.json
{
  "dependencies": {
    "workbox-background-sync": "5.1.4",
    "workbox-broadcast-update": "5.1.4",
    "workbox-cacheable-response": "5.1.4",
    "workbox-core": "5.1.4",
    "workbox-expiration": "5.1.4",
    "workbox-google-analytics": "5.1.4",
    "workbox-navigation-preload": "5.1.4",
    "workbox-precaching": "5.1.4",
    "workbox-range-requests": "5.1.4",
    "workbox-routing": "5.1.4",
    "workbox-strategies": "5.1.4",
    "workbox-streams": "5.1.4",
  }
}
ハトすけハトすけ

service worker のupdateトリガーを調べてみた。

https://developers.google.com/web/fundamentals/primers/service-workers/lifecycle?hl=ja#updates

  • アップデートは、次の場合にトリガーされます:
    • スコープ内ページへのナビゲーション時
    • push や sync などの機能イベントの発生時(24 時間以内にアップデート チェックが実行された場合を除く)
    • .register() の呼び出し時(Service Worker URL が変更された場合のみ

https://nhiroki.jp/2018/02/15/service-worker-install-and-update-scripts

  • 前回のスクリプトの更新確認から 24 時間以上経過した場合
  • それ以外にもブラウザが任意のタイミングで更新確認をすることが仕様上許可されています。例えば Chrome では Fetch イベントや Push イベントの発火などによって Service Worker が起動するときに更新確認しています2
  • また、ServiceWorkerRegistration オブジェクトの update() によって JavaScript から明示的に更新確認することができます。

スコープ内ページへのナビゲーション時

これSPAの場合だとページ移動されてもupdateがトリガーされてない気がする。

以下のstackoverflowでも同じこと書かれている。
https://stackoverflow.com/questions/51748241/checking-for-service-worker-updates-in-a-single-page-app

Because your SPA doesn't use real navigations, you won't get the automatic update checks mentioned in the first bullet point.
What I'd probably do is to modify your SPA's router and automatically make a call to reg.update() whenever your router is about to switch to a new view. That would simulate the same update-on-navigation behavior that you'd get in a non-SPA.

つまり、routerでlistenしてページ変わるごとに、service workerを手動でupdateさせるしかないよとのこと。

しかしこのJeffさん service woker 関連のstack overflowにめっちゃでてくる笑

その結果、コメントである人が解決策を実装してみている。
https://github.com/rahuls360/testing-sw
該当箇所
https://github.com/rahuls360/testing-sw/blob/62013f3338c7352f4c47cbd574fdd3e5fcbf057e/src/App.js#L11

App.tsx
import { BrowserRouter } from 'react-router-dom';

import './App.css';
import Routes from './routes';

const App: React.FC = () => {
  return (
    <BrowserRouter>
        <Routes />
    </BrowserRouter>
  );
};

export default App;
routes.tsx
const Routes = () => {
  useEffect(() => {
      // NOTE: service workerをページを移動するたびにupdateチェックする。
      // https://stackoverflow.com/questions/51748241/checking-for-service-worker-updates-in-a-single-page-app
      // https://github.com/rahuls360/testing-sw/blob/master/src/App.js
      history.listen(() => {
        // check for sw updates on page change
        navigator.serviceWorker
          .getRegistrations()
          .then((registrations) => registrations.forEach((reg) => reg.update()));
      });

      // Initialize google analytics page view tracking
      history.listen((thisLocation) => {
        if (process.env.REACT_APP_USE_GOOGLE_ANALYTICS === 'true') {
          ReactGA.set({ page: thisLocation.pathname }); // Update the user's current page
          ReactGA.pageview(thisLocation.pathname); // Record a pageview for the given page
        }
      });
    }, [history]);

  return (
        <Switch>
          <SomeComponent />
  </Switch>
 )
}

export default Routes

このスクラップは2022/01/04にクローズされました