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`

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:

* Firefox: não há limite no tamanho do banco de dados. A interface do usuário irá apenas pedir a permissão para armazenar conjuntos com tamanho maior que 50mb. Este limite de tamanho pode ser customizado através da preferência dom.indexedDB.warningQuota (que é definida em http://mxr.mozilla.org/mozilla-central/source/modules/libpref/src/init/all.js).
* Google Chrome: veja https://developers.google.com/chrome...rage#temporary
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
-----------

* Conceitos Básicos sobre IndexedDB (en-US)
* Utilizando IndexedDB (en-US)
* Armazenando Imagens e Arquivos com IndexedDB
* Especificação da API de Indexed Database
* IndexedDB — O armazenamento em seu Navegador
* IndexedDB Exemplos
* IndexedDB Polyfill/Shim para navegadores que apenas suportam WebSQL (e.g. mobile WebKit)
* JQuery IndexedDB plugin