IDBDatabase: метод deleteObjectStore()

Базовая поддержка Широко доступна

Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна в браузерах с сентября 2021 года.

Примечание: Эта функция доступна в Веб-рабочих потоках.

Метод deleteObjectStore() интерфейса IDBDatabase удаляет хранилище объектов с заданным именем в подключенной базе данных, а также любые индексы, которые ссылаются на него.

Как и в случае с IDBDatabase.createObjectStore, этот метод может быть вызван только в рамках транзакции versionchange.

Синтаксис

deleteObjectStore(name)

Параметры

name: Имя хранилища объектов, которое требуется удалить. Имена чувствительны к регистру.

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

None (undefined).

Исключения

InvalidStateError DOMException: Выбрасывается, если метод не был вызван из обратного вызова транзакции versionchange.
TransactionInactiveError DOMException: Выбрасывается, если запрос выполняется для источника базы данных, которого не существует (например, был удален или удалён).
NotFoundError DOMException: Выбрасывается при попытке удалить хранилище объектов, которого не существует.

Примеры

const dbName = "sampleDB";
const dbVersion = 2;
const request = indexedDB.open(dbName, dbVersion);

request.onupgradeneeded = (event) => {
  const db = request.result;
  if (event.oldVersion < 1) {
    db.createObjectStore("store1");
  }

  if (event.oldVersion < 2) {
    db.deleteObjectStore("store1");
    db.createObjectStore("store2");
  }

  // etc. for version < 3, 4…
};

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

Спецификация
API индексированной базы данных 3.0 # ref-for-dom-idbdatabase-deleteobjectstore①

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

	Рабочий стол					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox для Android	Opera Android	Safari на iOS	Samsung Internet	WebView Android
`deleteObjectStore`	23	12	10	15	8	25	22	14	8	1.5	4.4

См. также

Использование IndexedDB
Запуск транзакций: IDBDatabase
Использование транзакций: IDBTransaction
Установка диапазона ключей: IDBKeyRange
Получение и внесение изменений в данные: IDBObjectStore
Использование курсоров: IDBCursor
Пример ссылки: Уведомления о задачах (Просмотреть пример в браузере).

© 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/IDBDatabase/deleteObjectStore