IndexedDB

IndexedDB é uma API para armazenamento client-side de quantidades significantes de informações e buscas com alta performance por índices. Enquanto DOM Storage (en-US) é ú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écnica dos objetos da API. Precisando de suporte ainda mais inicial consulte os Conceitos Básicos sobre IndexedDb (en-US). Para mais detalhes sobre a implementação, veja Usando IndexedDB (en-US).

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 (en-US), 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() (en-US) no atributo indexedDB (en-US) do objeto window (en-US), que retornará um objeto IDBRequest (en-US). Operações assíncronas comunicam-se com a aplicação que os chamam executando eventos nos objetos IDBRequest (en-US).

Nota: 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 (en-US)

Itera sobre objectStores e índices e retorna o atual valor do cursor

IDBDatabase (en-US)

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 (en-US)

Provides access to the metadata of an index.

IDBKeyRange (en-US)

Define um alcance das chaves.

IDBObjectStore (en-US)

Representa um ObjectStore

IDBOpenDBRequest (en-US)

Representa uma requisição para abrir o banco de dados.

IDBRequest (en-US)

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 (en-US)

Representa uma transação. Você cria a transaçã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 This is an obsolete API and is no longer guaranteed to work.

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 (en-US). A versão síncrona não tem implementação em qualquer navegador. É feita para ser utilizada com WebWorkers (en-US).

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:

Exemplos

  • 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.

Veja Também