API Offline (автономная работа) — краткий справочник

API Offline (автономная работа) — краткий справочник.

API автономной работы представляет собой набор техник, в том числе специальный файл под названием «манифест» и несколько методов, событий и свойств. Все они предназначены для того, чтобы работающие в браузере приложения могли быть кэшированы на компьютере пользователя. Основное назначение данного API — обеспечивать постоянный доступ к приложениям, в том числе возможность работать с ними даже в условиях отсутствия подключения к Интернету.

Файл манифеста

Файл манифеста — это текстовый файл с расширением. manifest, содержащий список файлов, которые должны быть помещены в кэш. Он всегда начинается со строки CACHE MANIFEST, а его содержимое можно разбить на следующие категории:

- CACHE. В эту категорию помещаются кэшируемые файлы;

- NETWORK. К этой категории относятся файлы, обращение к которым возможно только через сетевое подключение;

- FALLBACK. В этой категории перечисляются альтернативные ресурсы для файлов с сервера, недоступных в данный момент.

Свойства

У объекта Navigator появилось новое свойство, позволяющее проверять состояние подключения:

- onLine. Возвращает булево значение, указывающее на состояние подключения. Равно false, если браузер работает автономно, и true — в противном случае.

В данном API предусмотрено свойство status, предназначенное для проверки статуса кэша приложения. Это свойство принадлежит объекту ApplicationCache и может принимать следующие значения:

- UNCACHED (значение 0). Указывает, что кэш для приложения еще не создавался;

- IDLE (значение 1). Указывает, что кэш для приложения актуален и используется;

- CHECKING (значение 2). Указывает, что браузер проверяет обновления;

- DOWNLOADING (значение 3). Указывает, что браузер находится в процессе загрузки файлов кэша;

- UPDATEREADY (значение 4). Указывает, что кэш для приложения доступен и используется, но неактуален; обновление готово для загрузки и замены старых файлов;

- OBSOLETE (значение 5). Указывает, что текущий кэш больше не используется.

События

У объекта окна есть два события, позволяющие проверять статус подключения:

- online. Срабатывает, когда значение свойства onLine меняется на true;

- offline. Срабатывает, когда значение свойства onLine меняется на false.

В API также предусмотрено несколько принадлежащих объекту Applica-tionCache событий, которые информируют о различных условиях, связанных с кэшем:

- checking. Срабатывает, когда браузер проверяет обновления;

- noupdate. Срабатывает, если обновления не обнаружены;

- downloading. Срабатывает, если браузер обнаружил обновление и начал загрузку файлов;

- cached. Срабатывает, когда кэш готов;

- updateready. Срабатывает, когда процесс загрузки обновления завершается;

- obsolete. Срабатывает, когда обнаруживается, что файл манифеста недоступен, и кэш удаляется;

- progress. Срабатывает во время процесса загрузки файлов кэша;

- error. Срабатывает, если во время создания или обновления кэша происходит ошибка.

Два метода в рассматриваемом API позволяют запросить обновление кэша:

- update(). Инициирует обновление кэша. Заставляет браузер загрузить файл манифеста и в случае, если обнаруживаются изменения, обновить и остальные файлы в кэше;

- swapCache(). Переключает браузер на самую свежую версию кэша после обновления. Не запускает сценарии и не заменяет ресурсы, просто сообщает браузеру, что в дальнейшем информацию можно считывать из нового кэша.

Добавить комментарий

Ваш e-mail не будет опубликован. Обязательные поля помечены *