# j-ServiceWorker

> Cache SPA активи и офлайн падане с служител.

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

Компонентът регистрира /sw-jcomponent.js и го изпраща на списъка с активи, кеш версията и офлайн паунд от източника на данни. Сервирайте приложението чрез HTTPS или localhost и поставете работника в коренния URL, така че да може да се справя с страниците на приложенията.

- Първо, трябва да поставите кода по-долу във файла например `sw-jcomponent.js` и да го поставите на `public` (например `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)}))})})}
```

- Компонентът ще комуникира с този код _service worker_.

__Конфигуриране__:

- Данните за изтичане на `expire {String}` от потребителското съхранение (предварително: `1 day`) __ ние не препоръчваме промяна на това__
- `debug {Boolean}` позволява режим на `debug`.Той ще обновява активите всеки презареждане (така че не е необходимо да промените версията) (предварително: `false`)
- Пътят `datasource {String}` към източника на данни (данният източник е обект)

__Структура на данните__:

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

__Добре е да се знае__:
- __PATH__ може да се използва като динамична версия. тя ще освежи активи веднага (без презареждане на страница) например `SET('version', '1.35')`
- След добавяне / премахване на нещо от активите, не е необходимо да се увеличи версия
- __fallback__ изпълнява офлайн версия на html. e.g. `fallback: '/offline.html'`
- Активите могат да бъдат всичко: шрифтове, частични страници, CSS файлове, JavaScript файлове
- __Това работи само в Single Page приложения като [Това е](https://github.com/totaljs/spa) или [Това е](https://github.com/totaljs/emptyproject-pwa)__

__Използване__:

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

Източникът е: [Total.js съставки](https://github.com/totaljs/components/tree/910ed1a86f6e72b4f031d3ad0dc7844f9fc5cb8e/j-ServiceWorker)Авторски права на Денис Гренак. [Лицензът ми](/knowledge-licenses.json).