chrome.extensionTypes

Descrição

A API chrome.extensionTypes contém declarações de tipo para extensões do Chrome.

Tipos

ColorArray

Pendente

Tipo

[número, número, número, número]

CSSOrigin

Chrome 66 ou mais recente

A origem do CSS injetado.

Enumeração

"author"

"user"

DeleteInjectionDetails

Chrome 87 e versões mais recentes

Detalhes do CSS a ser removido. O código ou a propriedade do arquivo precisam ser definidos, mas não ao mesmo tempo.

Propriedades

  • allFrames

    booleano opcional

    Se allFrames for true, isso implica que o CSS precisa ser removido de todos os frames da página atual. Por padrão, ele é false e é removido apenas do frame superior. Se true e frameId estiverem definidos, o código será removido do frame selecionado e de todos os frames filhos.

  • código

    string opcional

    Código CSS a ser removido.

  • cssOrigin

    CSSOrigin opcional

    A origem do CSS a ser removido. O padrão é "author".

  • arquivo

    string opcional

    Arquivo CSS a ser removido.

  • frameId

    número opcional

    O frame de onde o CSS precisa ser removido. O padrão é 0 (o frame de nível superior).

  • matchAboutBlank

    booleano opcional

    Se matchAboutBlank for verdadeiro, o código também será removido dos frames about:blank e about:srcdoc se a extensão tiver acesso ao documento pai. Por padrão, ele é false.

DocumentLifecycle

Chrome 106 e versões mais recentes

O ciclo de vida do documento do frame.

Enumeração

"prerender"

"ativo"

"Em cache"

"pending_deletion"

ExecutionWorld

Chrome 111 e versões mais recentes

O mundo do JavaScript para um script ser executado. Pode ser um mundo isolado exclusivo para essa extensão, o mundo principal do DOM compartilhado com o JavaScript da página ou um mundo de scripts do usuário que só está disponível para scripts registrados na API User Scripts.

Enumeração

"ISOLATED"

"MAIN"

"USER_SCRIPT"

FrameType

Chrome 106 e versões mais recentes

O tipo de frame.

Enumeração

"outermost_frame"

"fenced_frame"

"sub_frame"

ImageDataType

Pendente

Dados de pixel de uma imagem. Precisa ser um objeto ImageData, por exemplo, de um elemento canvas.

Tipo

ImageData

ImageDetails

Detalhes sobre o formato e a qualidade de uma imagem.

Propriedades

  • formato

    ImageFormat opcional

    O formato da imagem resultante. O padrão é "jpeg".

  • qualidade

    número opcional

    Quando o formato é "jpeg", ele controla a qualidade da imagem resultante. Esse valor é ignorado para imagens PNG. À medida que a qualidade diminui, a imagem resultante tem mais artefatos visuais, e o número de bytes necessários para armazená-la diminui.

ImageFormat

Chrome 44 e versões mais recentes

O formato de uma imagem.

Enumeração

"jpeg"

"png"

InjectDetails

Detalhes do script ou CSS a ser injetado. O código ou a propriedade do arquivo precisam ser definidos, mas não ao mesmo tempo.

Propriedades

  • allFrames

    booleano opcional

    Se allFrames for true, isso implica que o JavaScript ou o CSS precisa ser injetado em todos os frames da página atual. Por padrão, ele é false e é injetado apenas no frame superior. Se true e frameId estiverem definidos, o código será inserido no frame selecionado e em todos os frames filhos.

  • código

    string opcional

    Código JavaScript ou CSS a ser injetado.

    Aviso:tenha cuidado ao usar o parâmetro code. O uso incorreto pode expor sua extensão a ataques de scripting em vários locais.

  • cssOrigin

    CSSOrigin opcional

    Chrome 66 ou mais recente

    A origem do CSS a ser injetado. Isso só pode ser especificado para CSS, não JavaScript. O padrão é "author".

  • arquivo

    string opcional

    Arquivo JavaScript ou CSS a ser injetado.

  • frameId

    número opcional

    Chrome 50 ou mais recente

    O frame em que o script ou o CSS precisa ser injetado. O padrão é 0 (o frame de nível superior).

  • matchAboutBlank

    booleano opcional

    Se matchAboutBlank for verdadeiro, o código também será injetado em frames about:blank e about:srcdoc se a extensão tiver acesso ao documento pai. Não é possível inserir o código em frames de nível superior "about:". Por padrão, ele é false.

  • runAt

    RunAt opcional

    O mais cedo que o JavaScript ou o CSS será injetado na guia. O padrão é "document_idle".

RunAt

Chrome 44 e versões mais recentes

O mais cedo que o JavaScript ou o CSS será injetado na guia.

Enumeração

"document_start"
O script é injetado após todos os arquivos do CSS, mas antes que qualquer outro DOM seja construído ou que qualquer outro script seja executado.

"document_end"
O script é injetado imediatamente após o DOM ser concluído, mas antes que subrecursos como imagens e frames sejam carregados.

"document_idle"
O navegador escolhe um momento para injetar o script entre "document_end" e imediatamente após o evento window.onload ser acionado. O momento exato da injeção depende da complexidade do documento e do tempo que ele leva para carregar, e é otimizado para a velocidade de carregamento da página. Os scripts de conteúdo em execução em "document_idle" não precisam detectar o evento window.onload. Eles são executados com certeza após a conclusão do DOM. Se um script precisar ser executado após window.onload, a extensão poderá verificar se onload já foi acionado usando a propriedade document.readyState.