StorageArea

A interface StorageArea é usada pela API browser.storage.

Métodos

clear()

browser.storage.StorageArea.clear(): Promise<void>

Remove todos os itens do armazenamento.

Retorna

  • Promessa<void>

    Chrome 95+ browser.* desde o Chrome 148

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

get()

browser.storage.StorageArea.get(
  keys?: string | string[] | object,
): 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.

Retorna

  • Promise<object>

    Chrome 95+ browser.* desde o Chrome 148

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

getBytesInUse()

browser.storage.StorageArea.getBytesInUse(
  keys?: string | string[],
): 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.

Retorna

  • Promise<number>

    Chrome 95+ browser.* desde o Chrome 148

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

getKeys()

Chrome 130+ browser.* desde o Chrome 148 
browser.storage.StorageArea.getKeys(): Promise<string[]>

Recebe todas as chaves do armazenamento.

Retorna

  • Promise<string[]>

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

remove()

browser.storage.StorageArea.remove(
  keys: string | string[],
): 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.

Retorna

  • Promessa<void>

    Chrome 95+ browser.* desde o Chrome 148

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

set()

browser.storage.StorageArea.set(
  items: object,
): 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).

Retorna

  • Promessa<void>

    Chrome 95+ browser.* desde o Chrome 148

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

setAccessLevel()

Chrome 102+ browser.* desde o Chrome 148 
browser.storage.StorageArea.setAccessLevel(
  accessOptions: object,
): 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.

Retorna

  • Promessa<void>

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

Eventos

onChanged

Chrome 73 ou mais recente browser.* desde o Chrome 148 
browser.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