JavaScript. Подробное руководство, 6-е издание
вернуться

Флэнаган Дэвид
Шрифт:

FileReader

FileReaderSync

Form

FormControl

FormData

FormValidity

Geocoordinates

Geolocation

GeolocationError

Geoposition

HashChangeEvent

History

HTMLCollection

HTMLFormControlsCollection

HTMLOptionsCollection

IFrame

Image

ImageData

Input

jQuery

Label

Link

Location

MediaElement

MediaError

MessageChannel

MessageEvent

MessagePort

Meter

Navigator

Node

NodeList

Option

Output

PageTransitionEvent

PopStateEvent

Processinglnstruction

Progress

ProgressEvent

Screen

Script

Select

Storage

StorageEvent

Style

Table

TableCell

TableRow

TableSection

Text

TextArea

TextMetrics

TimeRanges

TypedArray

URL

Video

WebSocket

Window

Worker

WorkerGlobalScope

WorkerLocation

WorkerNavigator

XMLHttpRequest

XMLHttpRequestUpload

Справочник по клиентскому JavaScript

ApplicationCache

прикладной интерфейс управления кэшем приложений (EventTarget)

Объект

ApplicationCache
– это значение свойства
applicationCache
объекта
Window
. Он определяет API управления обновлением кэшированных приложений. В простых кэшируемых приложениях не требуется использовать этот API: достаточно создать (и обновлять по мере необходимости) соответствующий файл объявления кэшируемого приложения, как описывается в разделе 20.4. В более сложных приложениях, где может возникнуть потребность более активно управлять обновлениями, можно использовать свойства, методы и обработчики событий, описываемые здесь. Подробности приводятся в разделе 20.4.2.

Константы

Следующие константы представляют допустимые значения свойства

status
,

unsigned short UNCACHED = 0

Это приложение не имеет атрибута

manifest
: оно не кэшируется.

unsigned short IDLE = 1

Файл объявления проверен, данное приложение сохранено в кэше и обновлено.

unsigned short CHECKING = 2

В настоящее время броузер проверяет файл объявления.

unsigned short DOWNLOADING = З

Броузер загружает и сохраняет в кэше файлы, перечисленные в объявлении.

unsigned short UPDATEREADY = 4

Была загружена и сохранена в кэше новая версия приложения.

unsigned short OBSOLETE = 5

Файл объявления не найден и приложение будет удалено из кэша.

Свойства

readonly unsigned short status

Это свойство описывает состояние кэша текущего документа. Оно может принимать одно из значений, перечисленных выше.

Методы

void swapCache

Когда свойство

status
получает значение
UPDATEREADY
, броузер управляет двумя версиями кэшируемого приложения: старые версии файлов из кэша, используемые запущенным приложением, и новые загруженные версии, которые будут использоваться при следующем запуске приложения. Приложение может вызвать
swapCache
, чтобы сообщить броузеру, что он может немедленно удалить старые версии и начать использовать новые версии файлов. Однако имейте в виду, что это может привести к конфликту версий, и гораздо безопаснее будет выполнить переход на новую версию, перезагрузив приложение вызовом метода
Location.reload
.

void update

Обычно броузер проверяет наличие новой версии файла объявления кэшируемого приложения каждый раз, когда это приложение загружается. Долгоживущие веб-приложения могут использовать этот метод, чтобы чаще проверять наличие обновлений.

Обработчики событий

В ходе проверки файла объявления и обновления кэша броузер возбуждает в объекте

ApplicationCache
целую серию событий. Для регистрации обработчиков событий можно использовать следующие свойства объекта
ApplicationCache
или методы интерфейса
EventTarget
, реализованные в объекте
ApplicationCache
. Обработчики большинства этих событий получают простой объект
Event
. Обработчики событий «progress» получают объект
ProgressEvent
, с помощью которого можно узнать, какой объем в байтах уже был загружен.

oncached
Возбуждается, когда приложение впервые сохраняется в кэше. Это последнее событие в последовательности.

onchecking
Возбуждается, когда броузер начинает проверку наличия обновленного файла объявления. Это первое событие в последовательности событий, генерируемых в кэшируемом приложении,

ondownloading
Возбуждается, когда броузер начинает загрузку ресурсов, перечисленных в файле объявления, т. е. либо когда приложение впервые помещается в кэш, либо когда оно обновляется. За этим событием обычно следует одно или более событий «progress».