# j-ServiceWorker

> Cache des actifs SPA et un retour hors ligne avec un travailleur de service.

Framework: jcomponent20
Product: jComponent 20 (jcomponent@20)
Language: fr
Content-SHA256: 76f863d2839c19b9c5b8d01424ece812dba73cf60815b80ac73cd1b85e309360
Snapshot: c0700e321579725c5cf4f5ace1ad7d2866d1b4f93c24a63c0b41b6b7998e976c
Sources: components@910ed1a86f6e72b4f031d3ad0dc7844f9fc5cb8e
Review: usage-reviewed

Le composant enregistre /sw-jcomponent.js et lui envoie la liste d'actifs, la version cache et le faillite hors ligne de sa source de données. Servir l'application sur HTTPS ou localhost, et placer le travailleur à l'URL racine afin qu'il puisse gérer les pages d'applications.

- Tout d'abord, vous devez mettre le code ci-dessous dans le fichier par exemple `sw-jcomponent.js` et le placer sur le `public` (par exemple `myproject/public/sw-jcomponent.js`)

```js
var prefix='jc';function hash(s,unsigned){var hash=0,i,char;if(!s.length)return hash;var l=s.length;for(i=0;i<l;i++){char=s.charCodeAt(i);hash=((hash<<5)-hash)+char;hash|=0;}return unsigned?hash>>>0:hash}self.addEventListener('install',()=>{self.skipWaiting()});self.addEventListener('message',function(e){if(e.data.action==='jc-sw'){var data=e.data.data;data.name=prefix+'-'+data.version+'-'+hash(data.assets.toString(),true);addcache(e.data.data)}});self.addEventListener('fetch',function(e){e.respondWith(fetch(e.request).catch(function(){return caches.match(e.request).then(function(response){if(response)return response;if(e.request.mode==='navigate'||(e.request.method==='GET'&&e.request.headers.get('accept').includes('text/html')))return caches.match('jc-offline-fallback')})}))});function addcache(data){caches.open(data.name).then(function(cache){if(data.assets&&data.assets.length)cache.addAll(data.assets);if(data.fallback){fetch(data.fallback,{mode:'no-cors'}).then(function(response){return cache.put('jc-offline-fallback',response)})}}).then(function(){caches.keys().then(function(keys){return Promise.all(keys.map(function(key){if(data.name!==key)return caches.delete(key)}))})})}
```

- Le composant communiquera avec ce code _service worker_.

__Configuration__ :

- Les données d'expiration de `expire {String}` provenant du stockage des utilisateurs (défaut: `1 day`) __nous ne recommandons pas de changer cela__
- `debug {Boolean}` permet le mode `debug`. il renouvelle les actifs à chaque recharge (par conséquent, vous n'avez pas besoin de modifier la version) (defaut: `false`)
- `datasource {String}` route vers la source de données (source de données est un objet)

__La structure des données__:

```js
{
	version: '1.00',
	fallback: '/',
	assets: [
		'/js/default.js'
	]
}
```

__Bon à savoir__ :
- __PATH__ peut être utilisé en tant que version dynamique. Il réfrigère les actifs instantanément (sans recharge de page) par exemple `SET('version', '1.35')`
- Après avoir ajouté / supprimé quelque chose des actifs, vous n'avez pas besoin d'augmenter la version
- __fallback__ fonctionne en version hors ligne de html. e.g. `fallback: '/offline.html'`
- Les actifs peuvent être tout: les phares, les pages partielles, les fichiers CSS, les fiches javascript
- _Il ne fonctionne que dans les applications de page unique comme [Cette](https://github.com/totaljs/spa) ou [Cette](https://github.com/totaljs/emptyproject-pwa)__

__Utilisation__ :

```html
<ui-component name="serviceworker" path="version" config="datasource:mysource"></ui-component>

<script>
	var version = '1.34';
	var mysource = {
		version: version,
		fallback: '/',
		assets: [
			'/pages/settings.html',
			'/pages/articles.html',
			'/pages/dashboard.html'
		]
	};
</script>
```

source : [Total.js Les composants](https://github.com/totaljs/components/tree/910ed1a86f6e72b4f031d3ad0dc7844f9fc5cb8e/j-ServiceWorker)Le droit d’auteur : Denis Granec. [Mise en licence](/knowledge-licenses.json).