StorageArea

refresh date: 2026-09-25 robots: noindex

A interface StorageArea é usada pela API chrome.storage.

Métodos

clear()

Promessa 
chrome.storage.StorageArea.clear(
  callback?: function,
): Promise<void>

Remove todos os itens do armazenamento.

Parâmetros

  • callback

    função optional

    O parâmetro callback é semelhante a: 

    () => void

Retorna

  • Promessa<void>

    Chrome 95+

    Promessa que é resolvida em caso de sucesso ou rejeitada em caso de falha.

    As promessas só são compatíveis com o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

get()

Promessa 
chrome.storage.StorageArea.get(
  keys?: string | string[] | object,
  callback?: function,
): Promise<object>

Recebe um ou mais itens do armazenamento.

Parâmetros

  • chaves

    string | string[] | objeto opcional

    Uma única chave a ser recebida, uma lista de chaves a serem recebidas ou um dicionário que especifica valores padrão (consulte a descrição do objeto). Uma lista ou um objeto vazio vai retornar um objeto de resultado vazio. Transmita null para receber todo o conteúdo do armazenamento.

  • callback

    função optional

    O parâmetro callback é semelhante a: 

    (items: object) => void

    • itens

      objeto

      Objeto com itens nos mapeamentos de chave-valor.

Retorna

  • Promise<object>

    Chrome 95+

    Promessa que é resolvida com um objeto que contém um mapa de chave-valor para os itens solicitados ou rejeitada em caso de falha.

    As promessas só são compatíveis com o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

getBytesInUse()

Promessa 
chrome.storage.StorageArea.getBytesInUse(
  keys?: string | string[],
  callback?: function,
): Promise<number>

Recebe a quantidade de espaço (em bytes) que está sendo usada por um ou mais itens.

Parâmetros

  • chaves

    string | string[] opcional

    Uma única chave ou lista de chaves para receber o uso total. Uma lista vazia retorna 0. Transmita null para ver o uso total de todo o armazenamento.

  • callback

    função optional

    O parâmetro callback é semelhante a: 

    (bytesInUse: number) => void

    • bytesInUse

      número

      Quantidade de espaço usado no armazenamento, em bytes.

Retorna

  • Promise<number>

    Chrome 95+

    Promessa que é resolvida com a quantidade de espaço que está sendo usada pelo armazenamento ou rejeitada em caso de falha.

    As promessas só são compatíveis com o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

getKeys()

Promessa Chrome 130+ 
chrome.storage.StorageArea.getKeys(
  callback?: function,
): Promise<string[]>

Recebe todas as chaves do armazenamento.

Parâmetros

  • callback

    função optional

    O parâmetro callback é semelhante a: 

    (keys: string[]) => void

    • chaves

      string[]

      Matriz com chaves lidas do armazenamento.

Retorna

  • Promise<string[]>

    Promessa que é resolvida com chaves de armazenamento ou rejeitada em caso de falha.

    As promessas só são compatíveis com o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

remove()

Promessa 
chrome.storage.StorageArea.remove(
  keys: string | string[],
  callback?: function,
): Promise<void>

Remove um ou mais itens do armazenamento.

Parâmetros

  • chaves

    string | string[]

    Uma única chave ou uma lista de chaves para os itens a serem removidos.

  • callback

    função optional

    O parâmetro callback é semelhante a: 

    () => void

Retorna

  • Promessa<void>

    Chrome 95+

    Promessa que é resolvida em caso de sucesso ou rejeitada em caso de falha.

    As promessas só são compatíveis com o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

set()

Promessa 
chrome.storage.StorageArea.set(
  items: object,
  callback?: function,
): Promise<void>

Define vários itens.

Parâmetros

  • itens

    objeto

    Um objeto que fornece cada par de chave-valor para atualizar o armazenamento. Os outros pares de chave-valor no armazenamento não serão afetados.

    Valores primitivos, como números, serão serializados como esperado. Os valores com typeof "object" e "function" normalmente são serializados para {}, com exceção de Array (serializa conforme o esperado), Date e Regex (serializam usando a representação String).

  • callback

    função optional

    O parâmetro callback é semelhante a: 

    () => void

Retorna

  • Promessa<void>

    Chrome 95+

    Promessa que é resolvida em caso de sucesso ou rejeitada em caso de falha.

    As promessas só são compatíveis com o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

setAccessLevel()

Promise Chrome 102+ 
chrome.storage.StorageArea.setAccessLevel(
  accessOptions: object,
  callback?: function,
): Promise<void>

Define o nível de acesso desejado para a área de armazenamento. Por padrão, o armazenamento session é restrito a contextos confiáveis (páginas de extensão e service workers), enquanto o armazenamento managed, local e sync permite o acesso de contextos confiáveis e não confiáveis.

Parâmetros

  • accessOptions

    objeto

    • accessLevel

      AccessLevel

      O nível de acesso da área de armazenamento.

  • callback

    função optional

    O parâmetro callback é semelhante a: 

    () => void

Retorna

  • Promessa<void>

    Promessa que é resolvida em caso de sucesso ou rejeitada em caso de falha.

    As promessas só são compatíveis com o Manifest V3 e versões mais recentes. Outras plataformas precisam usar callbacks.

Eventos

onChanged

Chrome 73 ou mais recente 
chrome.storage.StorageArea.onChanged.addListener(
  callback: function,
)

Acionado quando um ou mais itens mudam.

Parâmetros

  • callback

    função

    O parâmetro callback é semelhante a: 

    (changes: object) => void

    • muda

      objeto