IDBFactory: метод deleteDatabase()

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

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

Примечание: Эта функция доступна в Web Workers.

Метод deleteDatabase() интерфейса IDBFactory запрашивает удаление базы данных. Метод возвращает объект IDBOpenDBRequest немедленно и выполняет операцию удаления асинхронно.

Если база данных успешно удалена, то событие success генерируется на объекте запроса, возвращённом этим методом, с его свойством result установленным в значение undefined. Если при удалении базы данных произошла ошибка, то событие error генерируется на объекте запроса, возвращённом этим методом.

При вызове deleteDatabase(), любые другие открытые подключения к этой базе данных получат событие versionchange.

Синтаксис

// For the current standard:
deleteDatabase(name)

// For the experimental version with `options` (see below):
deleteDatabase(name)
deleteDatabase(name, options)

Параметры

name: Имя базы данных, которую вы хотите удалить. Обратите внимание, что попытка удалить несуществующую базу данных не вызывает исключение, в отличие от IDBDatabase.deleteObjectStore(), которая вызывает исключение, если указанный объект хранилища не существует.
options Необязательный Нестандартный: В Gecko, начиная с версии 26, можно указать нестандартный необязательный параметр хранилища, который определяет, хотите ли вы удалить permanent (значение по умолчанию) IndexedDB или indexedDB в temporary хранилище (также известном как общий пул).

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

Объект IDBOpenDBRequest, на котором впоследствии генерируются события, связанные с этим запросом.

Если операция выполнена успешно, значение свойства result запроса равно null.

Примеры

const DBDeleteRequest = window.indexedDB.deleteDatabase("toDoList");

DBDeleteRequest.onerror = (event) => {
  console.error("Error deleting database.");
};

DBDeleteRequest.onsuccess = (event) => {
  console.log("Database deleted successfully");

  console.log(event.result); // should be undefined
};

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

Спецификация
Indexed Database API 3.0 # ref-for-dom-idbfactory-deletedatabase①

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

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