# j-ServiceWorker

> Cache SPA aktivy a offline zpět s servisním pracovníkem.

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

Komponenta registruje /sw-jcomponent.js a odesílá jej seznam aktiv, cache verze a offline zpět z datového zdroje. Služba aplikace přes HTTPS nebo localhost, a umístění pracovníka na kořenové URL tak, aby mohlo zvládnout stránky aplikace.

- Nejprve musíte dát kód níže do souboru např. `sw-jcomponent.js` a umístit ho na `public` (např. `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)}))})})}
```

- Komponenta bude komunikovat s tímto kódem _service worker_.

__Konfigurace__:

- `expire {String}` Údaje o uplynutí platnosti uživatelského ukládání (default: `1 day`• Neodporujeme změnu tohoto
- `debug {Boolean}` umožňuje režim `debug`. bude aktualizovat aktivy každým nahráváním (takže nemusíte měnit verzi) (podmínkou: `false`)
- `datasource {String}` cesta k datovému zdroji (datový zdroj je objekt)

__Struktura zdrojů__:

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

__Dobré vědět__:
- __PATH__ může být použit jako dynamická verze. bude okamžitě obnovit aktivy (bez přenosu stránek) např. `SET('version', '1.35')`
- Po přidání/odstranění něčeho z aktiv, nemusíte zvýšit verzi
- __fallback__ provádí offline verzi HTML. např. `fallback: '/offline.html'`
- Aktiva mohou být všechno: písmena, částečné stránky, CSS soubory, JavaScript soubory
- __To funguje pouze v Jednotlivé stránky aplikace jako [Tohle](https://github.com/totaljs/spa) nebo [Tohle](https://github.com/totaljs/emptyproject-pwa)__

__Použití__:

```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>
```

Zdroj : [Total.js součásti](https://github.com/totaljs/components/tree/910ed1a86f6e72b4f031d3ad0dc7844f9fc5cb8e/j-ServiceWorker)Autorská práva Denis Granec. [Licence](/knowledge-licenses.json).
