From 25debec66a35fc20db84bf5aca690489b5bec306 Mon Sep 17 00:00:00 2001 From: julieng Date: Sun, 11 Apr 2021 16:03:26 +0200 Subject: Archiving HTML - Using the Application cache --- .../html/using_the_application_cache/index.html | 383 --------------------- 1 file changed, 383 deletions(-) delete mode 100644 files/es/web/html/using_the_application_cache/index.html (limited to 'files/es/web') diff --git a/files/es/web/html/using_the_application_cache/index.html b/files/es/web/html/using_the_application_cache/index.html deleted file mode 100644 index 65a9554239..0000000000 --- a/files/es/web/html/using_the_application_cache/index.html +++ /dev/null @@ -1,383 +0,0 @@ ---- -title: Usar el caché de aplicaciones -slug: Web/HTML/Using_the_application_cache -tags: - - Firefox 3.5 - - HTML5 - - aplicaciones web sin conexión - - para_revisar -translation_of: Web/HTML/Using_the_application_cache -original_slug: Web/HTML/Recursos_offline_en_firefox ---- -

Introducción

- -

HTML5 proporciona un mecanismo de caché de aplicación que permite que las aplicaciones basadas en la web se ejecuten sin conexión. Los desarrolladores pueden usar la interface de Caché de aplicaciones (AppCache) para especificar los recursos que el navegador debería guardar en caché y tener disponibles para los usuarios cuando no estén conectados. Las aplicaciones que están en caché se cargan y funcionan correctamente aunque los usuarios hagan clic en el botón recargar cuando no están conectados.

- -

Usar el caché de aplicaciones le da a la aplicación los siguientes beneficios:

- - - -

¿Cómo funciona el caché de aplicaciones?

- -

Habilitando caché de aplicaciones

- -

Para habilitar el caché de aplicaciones, debe incluir el atributo {{htmlattrxref("manifest", "html")}} en el elemento {{HTMLElement("html")}} en las páginas de sus aplicaciones, como se muestra en el siguiente ejemplo:

- -
-
<html manifest="ejemplo.appcache"> 
-  ...
-</html>
-
-
- -

El atributo manifest referencia un archivo manifest de caché, que es un archivo de texto que lista los recursos (archivos) que el navegador deberá guardar en caché para la aplicación.

- -

Debería incluir el atributo manifest en cada página de la aplicación que quiera guardar en caché. El navegador no guardará páginas que no contengan el atributo  manifest, a menos que esas páginas estén específicamente listadas en el archivo manifest en sí mismo. No es necesario listar todas las páginas que se quieran guardar en caché en el archivo de manfifesto, el navegador implícitamente agrega cada página que el usuario visite y tenga el atributo manifest establecido para caché de aplicación.

- -

Algunos navegadores (ej. Firefox) muestran una notificación la primera vez que un usuario carga una aplicación que usa caché de aplicaciones La barra de notificaciones muestra un mensaje parecido a :

- -

Este sitio web (www.ejemplo.com) está pidiendo guardar datos en su equipo para usar sin conexión. [Permitir] [Nunca para este sitio] [No por ahora]

- -

El término "offline(-enabled) applications" a veces se refiere específicamente a aplicaciones a las que el usuario ha permitido que usen capacidades sin conexión.

- -

Cargando documentos

- -
-

Es uso de caché de aplicaciones modifica el proceso normal de la carga de un documento:

- - - -

El proceso para cargar documentos y actualizar el caché de aplicaciones está especificado con gran detalle aquí debajo:

-
- -
    -
  1. Cuando el navegador visita un documento que incluye el atributo manifest, si no existe caché de aplicaciones, el navegador carga el documento y baja todas las entradas listadas en el archivo del manifest, creando la primera versón de caché de aplicaciones. 
    2. -
  2. Posteriores visitas a ese documento causan que el navegador cargue el documento y otros archivos especificados en el manifest desde el caché de aplicaciones (no desde el servidor). Además, el navegador envía un evento checking al objeto window.applicationCache y descarga el archivo de manifest, siguiendo las reglas de caché HTTP apropiadas.
    3. -
  3. Si la copia del manifest actualmente en caché está actualizada, el navegador envía un evento noupdate al objeto applicationCache y el proceso de actualización está completo. Hay que tener en cuenta que si se cambia en el servidor cualquier recurso en caché, se deberá cambiar también el archivo de manifest, para que el navegador sepa que deberá descargar los recursos nuevamente.
    4. -
  4. Si el archivo de manifest ha cambiado, todos los archivos listados en el manifest—así como los que se agregaron al caché llamando applicationCache.add()—se descargarán en un caché temporario, siguiendo las reglas de caché  HTTP apropiadas. Para cada archivo descargado en este caché temporario, el navegador envía un evento progress al objeto applicationCache. Si ocurre cualquier error, el navegador envía un evento error y la actualización se detiene.
    5. -
  5. Una vez que todos los archivos han sido recuperados exitosamente, son movidos al caché sin conexión real automáticamente y un evento cached es enviado al objeto applicationCache. Como el documento ya ha sido cargado en el navegador desde caché, la actualización no se mostrará hasta que el documento sea re-cargado (ya sea manualmente o por programa).
    6. -
- -

Ubicación del almacenamiento y limpiando el caché sin conexión

- -

En Chrome se puede limpiar el caché sin conexión seleccionando "Clear browsing data..." en las preferencias o visitando chrome://appcache-internals/. Safari tiene una configuración similar"Vaciar cache" en sus preferencias, pero se requiere el reinicio del navegador.

- -

En Firefox, el caché sin conexión se guarda en un lugar separado del perfil de Firefox profile—cerca del caché de disco regular:

- - - -

En Firefox el estado actual del caché de aplicaciones puede ser inspeccionado en la página the about:cache (debajo del encabezado "Offline cache device"). El caché sin conexión pude limpiarse para cada sitio por separado usando el botón "Eliminar..." Herramientas -> Opciones -> Avanzadas -> Red -> Datos sin conexión.

- -

Antes de Firefox 11, ni Herramientas -> Limpiar historial reciente ni Herramientas -> Opciones -> Avanzadas -> Red -> Datos sin conexión -> Limpiar ahora borraban el caché sin conexión. Esto ha sido solucionado.

- -

Véase también limpiar los datos de almacenamiento de DOM.

- -
-

Los cachés de aplicaciones también pueden quedar obsoletos. Si el archivo de manifest de una aplicación es eliminado del servidor, el navegador elimina todo caché de la aplicación que use aquel manifest y envía un evento "obsoleted" al objeto applicationCache. Esto cambia el estado de caché de la aplicación a OBSOLETE.

-
- -

El archivo de manifest de caché

- -

Referenciando un archivo de manifest de caché

- -

El atributo manifest en una aplicación web puede especificar ya sea la ruta relativa de un archivo de manifest de caché o una URL absoluta (URLs absolutas deben estar en el mismo origen que la aplicación). Un archivo de manifest de caché puede tener cualquier extensión de archivo, pero debe ser enviada con el tipo MIME text/cache-manifest.

- -
Nota: En servidores Apache, el tipo MIME para los archivos de manifest (.appcache) puede establecerse agregando AddType text/cache-manifest .appcache a un archivo .htaccess dentro del directorio raíz o del mismo directorio que la aplicación.
- -

Entradas en el archivo de manifest de caché

- -

El archivo de manifest de caché es un archivo de texto simple que lista los recursos que el navegador debería guardar en caché para acceder sin conexión. Los recursos son identificados por URI. Las entradas listadas en el manifest de caché deben tener el mismo esquema, servidor y puerto que el manifest. 

- -

Ejemplo 1: un archivo de manifest de caché simple

- -
-

El siguiente es un archivo de manifest de caché simple, ejemplo.appcache, para un sitio web imaginario en www.ejemplo.com.

- -
CACHE MANIFEST
-# v1 - 2011-08-13
-# Esto es un comentario.
-http://www.ejemplo.com/index.html
-http://www.ejemplo.com/encabezado.png
-http://www.ejemplo.com/blah/blah
-
- -

Un archivo de manifest de caché puede incluir tres secciones (CACHE, NETWORK y FALLBACK, discutidas debajo). En el ejemplo mencionado, no hay encabezado de sección, así que todoas las líneas de datos se asumen como si estuvieran en la sección explícita (CACHE), lo que significa que el navegador deberá guardar en caché todos los recursos listados en el caché de aplicación. Los recursos pueden ser especificados como URLs absolutas o relativas (ej. index.html).

- -

El comentario "v1" en el ejemplo está ahí por una buena razón. Los navegadores solamente actualizan el caché de aplicación cuando el archivo de manifest cambia byte por byte. Si se cambia un recurso en caché (por ejemplo, si se actualiza la imagen header.png con nuevo contenido), se debe cambiar el contenido del archivo de manifest para que los navegadores sepan que se necesita actualizar el caché. Se puede hacer cualquier cambio al archivo de manifest, pero cambiar el número de versión es una práctica recomendada.

- -
Importante: No hay que especificar el manifest en el mismo archivo de manifest Do not specify the manifest, porque sería casi imposible informar al navegador que hay un nuevo manifest disponible.
- -

Secciones en un archivo de manifest de caché: CACHE, NETWORK y FALLBACK

- -

Un manifest puede tener tres secciones distintas: CACHE, NETWORK y FALLBACK.

- -
-
CACHE:
-
Esta es la sección predeterminada para las entradas en el archivo de manifest de caché. Los archivos listados bajo el encabezado de sección CACHE: (o inmediatamente después de la línea CACHE MANIFEST) son guardados en caché explícitamente después de ser descargados la primera vez.
-
NETWORK:
-
Los archivos listados bajo el encabezado de sección NETWORK: en el archivo de manifest de caché son recursos en lista blanca que requieren una conexión al servidor. Todos los pedidos a esos recursos evitan el caché aunque el usuario esté desconectado. Se pueden usar comodines.
-
FALLBACK:
-
La sección FALLBACK: especifica las páginas que el navegador debería usar si un recurso no es accesible. Cada entrada en esta sección lista dos URIs—lla primera es el recurso, la seguda es el fallback. Ambas URIs deben ser relativas y del mismo origen que el archivo de manifest. Se pueden usar comodines.
-
- -

Las secciones CACHE, NETWORK y FALLBACK pueden lsitarse en cualquier orden en el archivo de manifest y cada sección puede aparecer más de una vez en un manifest.

- -

Ejemplo 2: un archivo de manifest de caché más completo

- -

El siguiente es un archivo de manifest de caché para el sitio web imaginario en www.ejemplo.com:

- -
CACHE MANIFEST
-# v1 2011-08-14
-# Este es otro comentario
-index.html
-cache.html
-style.css
-image1.png
-
-# Usar desde la red si está disponible
-NETWORK:
-network.html
-
-# Contenido de fallback
-FALLBACK:
-/ fallback.html
-
- -

Este ejemplo usa las secciones NETWORK y FALLBACK para especificar la página network.html que deber ser recuperada desde la red y que la página fallback.html servirá como fallback (ej. en caso que una conexión al servidor no pueda establecerse).

- -

Estructura de un archivo de manifest de caché

- -

Los archivos de manifest de caché deben enviarse con el tipo MIME text/cache-manifest. Todos los recursos servidos usando este tipo MIME deben seguir la sintaxis para un manifest de caché de aplicación, como se define en esta sección.

- -

Los manifests de caché son archivos de texto en formato UTF-8 y pueden incluír opcionalmente un caracter BOM. Las nuevas líneas pueden ser representadas por salto de línea (U+000A), retorno de carro (U+000D) o ambos retorno de carro y salto de línea.

- -

La primera línea del manifest de caché debe consistir en la cadena CACHE MANIFEST (con un solo espacio U+0020 entre ambas palabras), seguido de cero o más espacios con caracteres de tabulación. Cualquier otro texto en la línea es ignorado.

- -

El resto del manifest de caché debe estar compuesto por cero o más de las siguientes líneas:

- -
-
Línea en blanco
-
Se pueden usar líneas en blanco compuestas por cero o más espacios y caracteres de tabulación.
-
Comentario
-
Los comentarios consisten en cero o más tabulaciones o espacios seguidos por un caracter # seguido de cero o más caracteres del texto del comentario. Los comentarios pueden usarse solamente en sus propias líneas y no pueden agregarse a otras líneas. Esto signifíca que no puede espcificar identificadores de fragmento.
-
Encabezado de sección
-
Los encabezados de sección especifican qué sección del manifest de caché está siendo manipulada. Hay tres encabezados de sección posibles:
-
- -
- - - - - - - - - - - - - - - - - - - -
Encabezado de secciónDescripción
CACHE:Cambia a la sección explícita del manifest de caché (esta es la sección predeterminada).
NETWORK:Cambia a la sección de lista blanca del manifest de caché.
FALLBACK:Cambia a la sección fallback del manifest de caché.
-
- -
-
La línea de encabezado de sección puede incluir espacios en blanco, pero debe incluir los dos puntos (:) en el nombre de sección.
-
Datos de sección
-
El formato de las líneas de datos varía de sección a sección. En la sección explícita (CACHE:), cada línea es una URI o referencia IRI a un recurso a guardar en caché (no se permiten caracteres comodines en esta sección). El espacio en blanco se permite antes y después de la URI o IRI en cada línea. En la sección Fallback cada línea es una URI o referencia IRI válida a un recurso, seguida por un recurso de fallback que será enviado cuando la comunicación con el servidor no pueda establecerse. En la sección Network, cada línea es una URI o referencia IRI válida a un recurso a obtener desde la red (se permite el caracter comodín * en esta sección). -
Nota: URIs relativas son relativas a la URI del manifest de caché, no a la URI del documento que hace referencia al manifest.
-
-
- -

Los archivos de manifest de caché pueden cambiar de sección a sección a voluntad (cada encabezado de sección puede usarse más de una vez) y se permite que las secciones estén vacías.

- -

Recursos en un caché de aplicación

- -

Un caché de aplicación siempre incluye al menos un recurso, identificado por URI. Todos los recursos entran en una de las siguientes categorías:

- -
-
Entradas maestras
-
Estos son recursos adicionados al caché porque un contexto de navegación visitado por el usuario incluyó un documento que indicó que estaba en caché usando el atributo manifest.
-
Entradas explícitas
-
Estos recursos están listados explícitamente en el archivo de manifest de caché de la aplicación.
-
Entradas de red
-
Estos son recursos listados en el archivo de manifest de caché de la aplicación como entradas de red.
-
Entradas de fallback
-
Estos son recursos listados en el archivo de manifest de caché de la aplicación como entradas de fallback.
-
- -
Nota: Los recursos pueden estar etiquetados en múltiples categorías y por lo tanto ser categorizados como entradas múltiples. Por ejemplo, una entrada puede ser explícita y fallback a la vez.
- -

Las categorías de recursos se describen con más detalle debajo.

- -

Entradas principales

- -

Una entrada maestra es cualquier archivo HTML que incluya un atributo {{ htmlattrxref("manifest","html") }} en su elemento {{ HTMLElement("html") }}.  Por ejemplo, digamos que tenemos el archivo http://www.ejemplo.com/entrada.html, que incluye el siguiente texto:

- -
<html manifest="ejemplo.appcache">
-  <h1>Ejemplo de cache de aplicacion</h1>
-</html>
-
- -

Si entrada.html no está listado en el archivo de manifest de caché ejemplo.appcache, visitar la pagina entrada.html causa que se agregue al caché de aplicación el archivo entrada.html como entrada maestra.

- -

Entradas explícitas

- -

Las entradas explícitas son recursos que están listados explicitamente en la seccion CACHE de un archivo de manifest de caché.

- -

Entradas de red

- -

La sección NETWORK de un archivo de manifest de caché especifíca recurso para los cuales una aplicacion web requiere acceso a internet. Las entradas de red en el caché de aplicación son escencialmente una "lista blanca online"—URIs especificadas en la sección NETWORK se cargarán desde el servidor en lugar del caché. Esto permite que el modelo de seguridad del navegador proteja al usuario de problemas de seguridad potenciales al limitar el acceso a recursos aprobados.

- -

Como ejemplo, puedes usar entradas en la seccion red para cargar y ejecutar scripts y otro código desde el servidor en lugar del caché:

- -
CACHE MANIFEST
-NETWORK:
-/api
-
- -

La sección de caché de manifest listada debajo asegura que las peticiones para cargar los recursos contenidos en  http://www.example.com/api/ siempre van a la red sin intentar acceder a la caché.

- -
Nota: Simplemente omitiendo las entradas principales (archivos que tienen el atributo manifest en el elemento html) del archivo manifest no tendrá el mismo resultado, porque las entradas principales serán agregadas—y posteriormente servida por—la aplicación de caché. 
- -

Entradas fallback

- -

Las entradas fallback son usadas cuando un intento de cargar los recursos falla. Por ejemplo, digamos que el archivo de anifest de caché http://www.example.com/example.appcache incluye el siguiente contenido:

- -
CACHE MANIFEST
-FALLBACK:
-example/bar/ example.html
-
- -

Cualquier petición a http://www.example.com/example/bar/ o cualquiera de sus directorios y su contenido hace que el explorador emita una solicitud de red al intentar cargar el recurso solicitado. Si la petición falla, debido a una falla de la red o un error de servidor de cualquier tipo, el navegador carga el archivo example.html en su lugar.

- -

Estados de caché

- -

Cada aplicación de caché tiene un estado, que indica el estado actual del caché. Cachés que comparten el mismo manifest URI comparten el mismo estado de caché, el cual puede ser uno de los siguientes:

- -
-
UNCACHED
-
Un valor especial que indica que un objeto caché de la aplicación no está inicializado en su totalidad.
-
IDLE
-
La caché de aplicación no está actualmente en el proceso de actualización.
-
CHECKING
-
El manifest se ha obtenido y revisado para actualizaciones.
-
DOWNLOADING
-
Recursos han sido descargados para ser añadidos al caché, debido a un cambio de recursos de manifest.
-
UPDATEREADY
-
Hay una nueva versión de la aplicación de caché disponible. Hay un correspondiente evento updateready, que es lanzado en lugar del evento cached cuando una nueva actualización acaba de ser descargada pero aún no ah sido activado el método swapCache().
-
OBSOLETE
-
La aplicación de caché de grupo es ahora obsoleta.
-
- -

Probando para actualizaciones para el manifest de caché

- -

Puedes programar para ver si una aplicación tiene un archivo de actualización del manifest de caché, usando JavaScript. Desde que un archio de manifest de caché tiene que ser actualizado antes de que un script adjunte eventos escuchas para probar para actualizaciones, los scripts siempre deben probar window.applicationCache.status.

- -
function onUpdateReady() {
-  alert('found new version!');
-}
-window.applicationCache.addEventListener('updateready', onUpdateReady);
-if(window.applicationCache.status === window.applicationCache.UPDATEREADY) {
-  onUpdateReady();
-}
- -

 Para comenzar a probar manualmente para un nuevo archivo manifest, puedes usar window.applicationCache.update().

- -

Contra indicaciones

- - - -

Compatibilidad del navegador

- -

{{ CompatibilityTable() }}

- -
- - - - - - - - - - - - - - - - - - - -
CaracterísticaChromeFirefox (Gecko)Internet ExplorerOperaSafari
Soporte básico4.03.510.010.64.0
-
- -
- - - - - - - - - - - - - - - - - - - -
CaracterísticaAndroidFirefox Mobile (Gecko)IE MobileOpera MobileSafari Mobile
Soporte básico2.1{{ CompatVersionUnknown() }}{{ CompatNo() }}11.03.2
-
- -

Nota: Versiones de Firefox anteriores a la 3.5 ignoran las secciones NETWORK y FALLBACK del archivo manifest de caché.

- -

Ver también

- - - -

{{ HTML5ArticleTOC() }}

-
-- cgit v1.2.3-54-g00ecf