# j-ServiceWorker

> Almacenar en caché los activos de SPA y un respaldo fuera de línea con un trabajador de servicio.

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

El componente registra /sw-jcomponent.js y le envía la lista de activos, la versión de caché y el respaldo sin conexión desde su fuente de datos. Entregue la aplicación a través de HTTPS o localhost y coloque el trabajador en la URL raíz para que pueda manejar las páginas de la aplicación.

- Este componente es un poco especial. En primer lugar, debe colocar el siguiente código en un archivo, por ejemplo. `sw-jcomponent.js` y colóquelo en `public` (por ejemplo, `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)}))})})}
```

- El componente se comunicará con este código de _trabajador de servicio_.

__Configuración__:

- `expire {String}` datos de caducidad del almacenamiento de los usuarios (predeterminado: `1 day`) __no recomendamos cambiar esto__
- `debug {Boolean}` habilita el modo `debug`. Actualizará los activos cada recarga (por lo que no es necesario cambiar la versión) (predeterminado: `false`)
- `datasource {String}` ruta a la fuente de datos (la fuente de datos es un objeto)

__Estructura de fuente de datos__:

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

__Es bueno saberlo__:
- __PATH__ se puede utilizar como versión dinámica. Actualizará los activos instantáneamente (sin recargar la página), p. `SET('version', '1.35')`
- Después de agregar/eliminar algo de los activos, no es necesario aumentar la versión
- __fallback__ realiza una versión fuera de línea de html. p.ej. `fallback: '/offline.html'`
- Los activos pueden ser cualquier cosa: fuentes, páginas parciales, archivos css, archivos javascript.
- __Funciona solo en aplicaciones de una sola página como [this](https://github.com/totaljs/spa) o [this](https://github.com/totaljs/emptyproject-pwa)__

__Uso__:

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

Fuente: [Total.js componentes](https://github.com/totaljs/components/tree/910ed1a86f6e72b4f031d3ad0dc7844f9fc5cb8e/j-ServiceWorker). Copyright Denis Granec. [Licencia MIT](/knowledge-licenses.json).