SharedStorage: метод append()

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

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

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

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

Синтаксис

append(key, value)

Параметры

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

Примечание: Если указанный key не найден в общем хранилище, операция append() эквивалентна set(), то есть в общее хранилище добавляется новая пара ключ-значение с указанным key.

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

Обещание Promise, которое выполняется со значением undefined.

Исключения

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

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

Примеры

window.sharedStorage
  .append("integer-list", ",9")
  .then(console.log("Value appended to integer list"));

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

Спецификация
Shared Storage API # dom-sharedstorage-append

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

	Рабочие столы					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox для Android	Opera Android	Safari на iOS	Samsung Internet	WebView Android
`append`	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/append