IndexedDB

by 1 colaborador:

IndexedDB é uma API para armazenamento client-side de quantidades significantes de informações e buscas com alta performance por índices. Enquanto DOM Storage é útil para armazenamento de pequenas quantidade de dados, IndexedDB é a solução para grande porção de dados estruturados.

Esta página basicamente é o ponto de entrada para uma descrição ténica dos objetos da API. Precisando de suporte ainda mais inicial consulte os Conceitos Básicos sobre IndexedDb. Para mais detalhes sobre a implementação, veja Usando IndexedDB.

IndexedDB provém APIs separadas para acesso tanto síncrono quanto assíncrono. As APIs síncronas devem ser utilizadas apenas dentro de Web Workers, apesar de não ser implementada por nenhum navegador atualmente. A API assíncrona funciona tanto com ou sem Web Workers, sendo que o Firefox ainda não implementou este.

API Assíncrona

Os métodos da API assíncrona são chamados sem bloquear a thread que os chama. Para obter acesso assíncrono à database, chame open() no atributo indexedDB do objeto window, que retornará um objeto IDBRequest. Operações assíncronas comunicam-se com a aplicação que os chamam executando eventos nos objetos IDBRequest.

Nota: O objeto indexedDB é prefixado em navegadores mais antigos (propriedade mozIndexedDB em Gecko < 16, webkitIndexedDb em Chrome e msIndexedDB no IE 10).

As interfaces da API assíncrona do IndexedDB são:

IDBFactory
Provém acesso ao banco de dados. É a interface implementado pelo objeto global indexedDB e é, portanto, o ponto de entrada para API.
IDBCursor
Itera sobre objectStores e índices
IDBCursorWithValue
Itera sobre objectStores e índices e retorna o atual valor do cursor
IDBDatabase
Represents a connection to a database. It's the only way to get a transaction on the database.
IDBEnvironment
Provides access to a client-side database. It is implemented by the window and worker objects.
IDBIndex
Provides access to the metadata of an index.
IDBKeyRange
Define um alcance das chaves.
IDBObjectStore
Representa um ObjectStore
IDBOpenDBRequest
Representa uma requisição para abrir o banco de dados.
IDBRequest
Provém acesso a resultados de requisições assíncronas ao banco de dados e a objetos do banco de dados. É o que você obtém quando chama um método assíncrono.
IDBTransaction
Representa uma transação. VocÊ cria a trnasação no banco de dados, especifíca o escopo (tal como qual objectStore você deseja acessar), e determina que tipo de acesso (apenas leitura ou também escrita) daquilo que você deseja.

Uma versão anterior da especificação também define estas interfaces agora removidas. Elas ainda estão documentadas caso você precise atualizar códigos escritos anteriormente:

IDBVersionChangeRequest
Representa uma requisição para alterar a versão do banco de dados. O modo de alterar a versão do banco de dados mudou então (chamando IDBFactory.open sem também chamar IDBDatabase.setVersion) e a interface IDBOpenDBRequest agora tem a funcionalidade do removido IDBVersionChangeRequest.
IDBDatabaseException 
Representa condições de erro que podem ser encontradas enquanto performando operações no banco de dados.

 Nota: há também a versão síncrona da API. A versão síncrona não tem implementação em qualquer navegador. É feita para ser utilizada com WebWorkers.

Limites de Armazenamento

Não há qualquer limite em um único elemento da database. Entretanto podem haver limites quanto ao tamanho de cada banco de dados. Este limite (e a maneira com qual o usuário chega a ele) pode variar de um navegador para outro:

Examples

  • Um grande exemplo de para o que o indexedDb pode ser utilizado  na web é o exemplo do Marco Castelluccion, vencedor do IndexedDB Mozilla DevDerby. A demonstração vencedora foi o eLibri, uma aplicação biblioteca e leitora de Ebook.
  • Você deveria também checar a referência de aplicações exemplo neste documento de referências: Notificações de A Fazer (veja ao vivo). Nem todo fragmento de código aparece neste exemplo, mas todo exemplo usa a mesma estrutura de dados e sintaxe, e fará sentido no contexto da aplicação.

Browser compatibility

Característica Chrome Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
API Assíncrona

11.0 webkit
24

4.0 (2.0) moz
16.0 (16.0)
10 17 Não suportado
API Síncrona (com WebWorkers) Não suportado Não suportado
See bug 701634
Não suportado Não suportado Não suportado
Feature Android Firefox Mobile (Gecko) IE Phone Opera Mobile Safari Mobile
API Assíncrona 4.4 6.0 (6.0) moz
16.0 (16.0)
10 17 Não suportado

Nota: alguns browsers ainda não suportam IndexedDB mas suportam WebSQL, mais especificamente Safari/Webkit no desktop e iOS. Uma maneira de driblar este problema é utilizar IndexedDB Polyfill ou Shim, que recorre ao WebSQL para navegadores que não suportam.

Veja Também

Etiquetas do documento e colaboradores

Contributors to this page: cirocosta
Última atualização por: cirocosta,