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

StorageEvent

StorageEvent

Event

Свойства localStorage и sessionStorage объекта Window ссылаются на объекты Storage, представляющие хранилища на стороне клиента (раздел 20.1). Если имеется несколько окон, вкладок или фреймов, отображающих документы с общим происхождением, все они будут иметь доступ к одному и тому же хранилищу. Если сценарий в одном окне изменит содержимое хранилища, во всех других объектах Window, имеющих доступ к этому хранилищу, будет сгенерировано событие «storage». (Обратите внимание, что это событие не генерируется в окне, в котором были выполнены изменения.) События «storage» генерируются в объекте Window и не всплывают. Для них не предусматривается действий по умолчанию, которые можно было бы отменить. Обработчикам события «storage» передается объект события StorageEvent, свойства которого описывают изменения, внесенные в хранилище.

Свойства

readonly string key

Это свойство хранит ключ, который был установлен или удален. Если все хранилище было очищено вызовом метода Storage.clear(), это свойство (а также свойства newValue и oldValue) будет иметь значение null.

readonly any newValue

Новое значение ключа key. Будет иметь значение null при удалении ключа. На момент написания этих строк броузеры позволяли сохранять только строковые значения.

readonly any oldValue

Старое значение изменившегося ключа key. Будет иметь значение null при добавлении нового ключа. На момент написания этих строк броузеры позволяли сохранять только строковые значения.

readonly Storage storageArea

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

readonly string url

URL-адрес документа, сценарий которого внес изменения в хранилище.

Оглавление книги