SharedStorage: метод delete()

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

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

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

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

Синтаксис

delete(key)

Параметры

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

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

Объект Promise, который выполняется с undefined.

Исключения

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

Примечание: Если пара "ключ-значение" не существует в общем хранилище, ошибка не генерируется — операция всё равно выполняется с undefined.

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

Примеры

window.sharedStorage
  .delete("ab-testing-group")
  .then(console.log("Value deleted"));

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

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

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

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