CKTIS / JavaScript
IndexedDB: tworzenie magazynów obiektów i otwieranie transakcji
Używaj `createObjectStore()` do zmiany schematu przy podnoszeniu wersji bazy, a `transaction()` do odczytu i zapisu w istniejących magazynach obiektów.
Wersja: ECMAScript 2024 and the current web platform; runtime support varies
Składnia
db.createObjectStore(name) → IDBObjectStore
db.createObjectStore(name, options) → IDBObjectStore
db.transaction(storeNames) → IDBTransaction
db.transaction(storeNames, mode) → IDBTransaction
db.transaction(storeNames, mode, options) → IDBTransactionIDBDatabase reprezentuje otwarte połączenie z bazą IndexedDB. db.createObjectStore(name, options) od razu zwraca nowy IDBObjectStore, ale działa tylko w aktywnej transakcji versionchange. IndexedDB otwiera ją automatycznie przy tworzeniu bazy lub otwieraniu jej z wyższą wersją przez indexedDB.open(); schemat zmieniaj w upgradeneeded. Otwarte połączenie w innej karcie może zablokować aktualizację: żądanie otwarcia zgłasza blocked, a stare połączenie może wywołać close() w odpowiedzi na zdarzenie versionchange.
Opcjonalne keyPath wskazuje, skąd pobrać klucz z wartości, np. z pola id; tablica ścieżek definiuje klucz złożony, a brak ścieżki oznacza klucz przechowywany osobno. autoIncrement domyślnie ma wartość false; true włącza generator kluczy, ale nie można go łączyć z pustym ciągiem ani tablicą jako keyPath (InvalidAccessError). Powtórzona nazwa magazynu daje ConstraintError, nieprawidłowa ścieżka — SyntaxError, a brak transakcji aktualizacji — InvalidStateError.
db.transaction(storeNames, mode, options) od razu zwraca IDBTransaction dla nazwy jednego magazynu podanej jako ciąg znaków lub dla niepustego obiektu iterowalnego zawierającego nazwy istniejących magazynów, np. tablicy albo obiektu Set. tx.objectStore(name) udostępnia magazyn z tego zakresu. Domyślny tryb "readonly" dopuszcza tylko odczyt, a "readwrite" także zapis. Trybu "versionchange" nie można wybrać w tym wywołaniu (TypeError). Nieznany magazyn daje NotFoundError, pusta lista — InvalidAccessError, a zamykane lub zamknięte połączenie — InvalidStateError. Opcjonalne options.durability ("default", "strict", "relaxed") jest wskazówką dotyczącą trwałości zapisu; sprawdź obsługę w docelowej przeglądarce.
Dodawaj żądania tylko wtedy, gdy transakcja jest aktywna: w zadaniu, które ją utworzyło, lub w procedurze obsługi zdarzenia success albo error jej żądania. Nie zakładaj, że transakcja pozostanie aktywna po await fetch(...): może zatwierdzić się automatycznie, a późniejsze żądanie może zgłosić TransactionInactiveError. Sukces żądania to nie sukces całej transakcji. complete potwierdza zatwierdzenie, a abort oznacza wycofanie zmian.
IndexedDB to API platformy WWW, nie część ECMAScript 2024. Dostęp do danych jest ograniczony do tego samego źródła (origin); ustawienia przeglądarki mogą ograniczać dostęp do pamięci lub czas przechowywania danych.
Przykłady
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>IndexedDB example</title>
</head>
<body>
<script>
(async () => {
const idb = window.indexedDB;
const name = `cktis-notes-${crypto.randomUUID()}`;
const requestResult = (request) => new Promise((resolve, reject) => {
request.onsuccess = () => resolve(request.result);
request.onerror = () => reject(request.error);
});
const finished = (tx) => new Promise((resolve, reject) => {
tx.oncomplete = () => resolve();
tx.onabort = () => reject(tx.error ?? new Error("Transaction aborted"));
});
const open = idb.open(name, 1);
open.onupgradeneeded = () => {
open.result.createObjectStore("notes", { keyPath: "id" });
};
const db = await requestResult(open);
db.onversionchange = () => db.close();
let title;
try {
const write = db.transaction("notes", "readwrite");
write.objectStore("notes").put({ id: 1, title: "IndexedDB" });
await finished(write);
const read = db.transaction("notes");
const get = read.objectStore("notes").get(1);
await finished(read);
title = get.result.title;
} finally {
db.close();
await requestResult(idb.deleteDatabase(name));
}
console.log(title);
})().catch((error) => console.error(error));
</script>
</body>
</html>Wynik
IndexedDB
Udostępnij plik HTML przez HTTPS i otwórz go w przeglądarce, w której zapis danych jest dozwolony. Przykład tworzy bazę o losowej nazwie, odczytuje rekord po zatwierdzeniu zapisu, zamyka i usuwa bazę, a następnie wypisuje `IndexedDB` w konsoli przeglądarki.
Powiązane lekcje
- JavaScript · Lekcja 31 · Zaawansowany · Wersja: 4
Źródła
- IDBDatabase: createObjectStore() method
- IDBDatabase: transaction() method
- IDBFactory: open() method
- Using IndexedDB
- IDBTransaction
- IDBTransaction: durability property
- IndexedDB key characteristics and basic terminology
- IDBObjectStore: put() method
- IDBObjectStore: get() method
- IDBFactory: deleteDatabase() method
- Crypto: randomUUID() method
- ECMAScript® 2024 Language Specification — Overview