chrome.extensionTypes

Descrição

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

Tipos

ColorArray

Chrome 139 ou mais recente

Tipo

[number, number, number, number]

CSSOrigin

Chrome 66 ou mais recente

A origem do CSS injetado.

Enumeração

"author"

"user"

DeleteInjectionDetails

Chrome 87 ou mais recente

Detalhes do CSS a ser removido. É necessário definir o código ou a propriedade do arquivo, mas não ambos ao mesmo tempo.

Propriedades

  • allFrames

    booleano opcional

    Se allFrames for true, isso significa que o CSS precisa ser removido de todos os frames da página atual. Por padrão, é false e só é removido 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

    number optional

    O frame de onde o CSS 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 principal. Por padrão, ele é false.

DocumentLifecycle

Chrome 106 ou mais recente

O ciclo de vida do documento do frame.

Enumeração

"prerender"

"ativo"

"cached"

"pending_deletion"

ExecutionWorld

Chrome 111 ou mais recente

O mundo JavaScript em que um script é executado. Pode ser um mundo isolado exclusivo desta extensão, o mundo principal do DOM compartilhado com o JavaScript da página ou um mundo de scripts de usuário disponível apenas para scripts registrados com a API User Scripts.

Enumeração

"ISOLATED"

"MAIN"

"USER_SCRIPT"

FrameType

Chrome 106 ou mais recente

O tipo de frame.

Enumeração

"outermost_frame"

"fenced_frame"

"sub_frame"

ImageDataType

Chrome 139 ou mais recente

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

Tipo

ImageData

ImageDetails

Detalhes sobre o formato, a qualidade e a área de uma imagem.

Propriedades

  • formato

    ImageFormat opcional

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

  • qualidade

    number optional

    Quando o formato é "jpeg", 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 ou mais recente

O formato de uma imagem.

Enumeração

"jpeg"

"png"

InjectDetails

Detalhes do script ou CSS a ser injetado. É necessário definir o código ou a propriedade do arquivo, mas não ambos ao mesmo tempo.

Propriedades

  • allFrames

    booleano opcional

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

  • 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 abrir sua extensão para ataques de scripting entre sites.

  • cssOrigin

    CSSOrigin opcional

    Chrome 66 ou mais recente

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

  • arquivo

    string opcional

    Arquivo JavaScript ou CSS a ser injetado.

  • frameId

    number optional

    Chrome 50 ou mais recente

    O frame em que o script ou CSS 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 principal. O código não pode ser inserido em about:-frames de nível superior. Por padrão, ele é false.

  • runAt

    RunAt opcional

    O momento mais próximo em que o JavaScript ou CSS será injetado na guia. O padrão é "document_idle".

RunAt

Chrome 44 ou mais recente

O momento mais próximo em que o JavaScript ou CSS será injetado na guia.

Enumeração

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

"document_end"
O script é injetado imediatamente após a conclusão do DOM, mas antes que sub-recursos 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 disparo do evento window.onload. O momento exato da injeção depende da complexidade do documento e do tempo de carregamento, sendo otimizado para a velocidade de carregamento da página. Os scripts de conteúdo executados em "document_idle" não precisam ficar aguardando o evento window.onload. Eles são executados depois que o DOM é concluído. Se um script precisar ser executado depois de window.onload, a extensão poderá verificar se onload já foi acionado usando a propriedade document.readyState.