SharedStorage: метод set()

Ограниченная доступность

Эта функция не является Baseline, так как она не работает в некоторых из самых широко используемых браузеров.

Экспериментально: Это экспериментальная технология.
Перед использованием в рабочей среде внимательно проверьте таблицу совместимости браузеров в таблице совместимости.

Метод set() интерфейса SharedStorage либо сохраняет новую пару "ключ-значение" в общем хранилище текущего происхождения, либо обновляет уже существующую.

Синтаксис

set(key, value)
set(key, value, options)

Параметры

key

Строка, представляющая ключ в паре "ключ-значение", которую вы хотите добавить или обновить.

value

Строка, представляющая значение, которое вы хотите добавить или обновить.

options Необязательно

Объект опций, содержащий следующие свойства:

ignoreIfPresent: Булево значение. Значение true заставляет операцию set прерваться, если пара "ключ-значение" с указанным key уже существует. Значение по умолчанию false заставляет операцию set перезаписать предыдущее значение.

Возвращаемое значение

A Promise который завершается с undefined.

Исключения

Promise отклоняется с TypeError, если:
- Созданная запись не была успешно сохранена в базе данных из-за отсутствия общего хранилища (например, оно отключено с помощью настройки браузера).
- key и/или value превышают максимальную длину, определенную браузером.
- Сайт-источник не имеет включенного API общего хранилища в успешно завершённом процессе регистрации в песочнице конфиденциальности.
В случае с WorkletSharedStorage, Promise отклоняется с TypeError, если модуль worklet не был добавлен с помощью SharedStorageWorklet.addModule().

Примечание: В случае с WindowSharedStorage, если операция set() не выполняет успешную запись в базу данных по причине, отличной от отсутствия общего хранилища, ошибка не генерируется — операция всё равно завершается с undefined.

Примеры

window.sharedStorage
  .set("ab-testing-group", "0", {
    ignoreIfPresent: true,
  })
  .then(console.log("Set operation completed"));

Спецификации

Спецификация
API общего хранилища # dom-sharedstorage-set

Совместимость браузеров

	Рабочие столы					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox для Android	Opera Android	Safari на iOS	Samsung Internet	WebView Android
`set`	117	117	Нет	103	Нет	117	Нет	78	Нет	24.0	117

См. также

API общего хранилища

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/SharedStorage/set