# j-ServiceWorker

> Cache SPA aktywów i offline Fallback z pracownikami serwisowymi.

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

Składnik rejestruje /sw-jcomponent.js i wysyła listę aktywów, wersję cache i offline fallback z jego źródła danych. Serwuj aplikację za pośrednictwem HTTPS lub lokalhost i umieszcza pracodawcę na korzeniowej adresie URL, aby mogła obsługiwać strony aplikacji.

- Po pierwsze, musisz umieścić kod poniżej w pliku np. `sw-jcomponent.js` i umieściť go na `public` (np. `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)}))})})}
```

- Składnik będzie komunikował się z tym kodem _service worker_.

__Konfiguracja__:

- Dane wygaśnięcia `expire {String}` z przechowywania użytkowników (default: `1 day`) _ nie zalecamy zmiany tego__
- `debug {Boolean}` umożliwia tryb `debug`. odświeża aktywa za każdym ponownym pobieraniem (tak że nie musisz zmieniać wersji) (default: `false`)
- Ścieżka `datasource {String}` do źródła danych (source of data is an object)

__Struktura źródła danych__:

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

__Dobrze wiedzieć__:
- __PATH__ może być używany jako dynamiczna wersja. odświeża aktywa natychmiast (bez ponownego ładowania strony) np. `SET('version', '1.35')`
- Po dodaniu / usunięciu czegoś z aktywów, nie musisz zwiększać wersji
- __fallback__ wykonuje wersję offline HTML. np. `fallback: '/offline.html'`
- Aktywa mogą być wszystko: czcionki, strony częściowe, pliki CSS, pliky javascript
- _To działa tylko w aplikacjach jednej strony jak [Tego](https://github.com/totaljs/spa) lub [Tego](https://github.com/totaljs/emptyproject-pwa)__

__Używanie__:

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

Źródło : [Składniki Total.js](https://github.com/totaljs/components/tree/910ed1a86f6e72b4f031d3ad0dc7844f9fc5cb8e/j-ServiceWorker)Prawo autorskie Denis Granec. [Licencja](/knowledge-licenses.json).