CKTIS / JavaScript
indexedDB.open — abrir uma base de dados e atualizar o respetivo esquema
indexedDB.open abre ou cria uma base de dados local de forma assíncrona. Devolve um pedido orientado a eventos; as alterações ao esquema devem ser feitas no processador upgradeneeded.
Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxe
indexedDB.open(name)
indexedDB.open(name, version)indexedDB.open(name, version) devolve um IDBOpenDBRequest, não uma Promise. Em success, request.result contém uma ligação IDBDatabase. Se version for omitido, é usada a versão atual da base de dados ou 1 para uma base de dados nova.
A versão é um número inteiro positivo. Uma versão superior ativa upgradeneeded: cria armazéns de objetos e índices nesta transação de atualização. success só ocorre depois de a atualização ser confirmada. Uma versão inferior causa um VersionError assíncrono; 0 lança um TypeError síncrono.
Outras ligações abertas podem causar blocked; isto significa que é preciso esperar, não que a operação tenha falhado definitivamente. Fecha-as com db.close() em resposta a versionchange. Trata tanto error como as exceções síncronas.
Esta é uma Web API, não faz parte de ECMAScript. Verifica a disponibilidade no browser de destino; Node 24 não a comprova. A política de armazenamento pode recusar o acesso. Se a abertura for bem-sucedida, o exemplo fecha a ligação e pede a eliminação da base de dados com indexedDB.deleteDatabase(name). No caso apresentado, em que ocorre um erro SecurityError, não é criada nenhuma base de dados.
Exemplos
(() => {
const name = `cktis-open-${crypto.getRandomValues(new Uint32Array(4)).join('-')}`;
const failed = error => console.log(`Open failed: ${error.name}`);
try {
const request = indexedDB.open(name, 1);
let upgradedFrom;
request.onupgradeneeded = event => {
upgradedFrom = event.oldVersion;
request.result.createObjectStore('notes');
};
request.onblocked = () => console.log('Open blocked by an open connection');
request.onerror = () => failed(request.error);
request.onsuccess = () => {
const db = request.result;
const version = db.version;
const hasNotes = db.objectStoreNames.contains('notes');
db.close();
indexedDB.deleteDatabase(name);
console.log(`Opened version ${version} from ${upgradedFrom}; notes store: ${hasNotes}`);
};
} catch (error) {
failed(error);
}
})();Resultado
Open failed: SecurityError
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.