browser.extensionTypes

Descrição

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

Tipos

ColorArray

Chrome 139+ browser.* desde o Chrome 148

Tipo

[number, number, number, number]

CSSOrigin

Chrome 66+ browser.* desde o Chrome 148

A origem do CSS injetado.

Enumeração

"author"

"user"

DeleteInjectionDetails

Chrome 87+ browser.* desde o Chrome 148

Detalhes do CSS a ser removido. É necessário definir a propriedade de código ou de arquivo, mas não as duas 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, ele é 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

    número 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 pai. Por padrão, ele é false.

DocumentLifecycle

Chrome 106+ browser.* desde o Chrome 148

O ciclo de vida do documento do frame.

Enumeração

"prerender"

"active"

"cached"

"pending_deletion"

ExecutionWorld

Chrome 111+ browser.* desde o Chrome 148

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

Enumeração

"ISOLATED"

"MAIN"

"USER_SCRIPT"

FrameType

Chrome 106+ browser.* desde o Chrome 148

O tipo de frame.

Enumeração

"outermost_frame"

"fenced_frame"

"sub_frame"

ImageDataType

Chrome 139+ browser.* desde o Chrome 148

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

    número 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 terá mais artefatos visuais, e o número de bytes necessários para armazená-la vai diminuir.

ImageFormat

Chrome 44+ browser.* desde o Chrome 148

O formato de uma imagem.

Enumeração

"jpeg"

"png"

InjectDetails

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

Propriedades

  • allFrames

    booleano opcional

    Se allFrames for true, isso significa que o JavaScript ou CSS precisa ser injetado em todos os frames da página atual. Por padrão, é 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 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 em vários sites.

  • cssOrigin

    CSSOrigin opcional

    Chrome 66+ browser.* desde o Chrome 148

    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 para injetar.

  • frameId

    número optional

    Chrome 50+ browser.* desde o Chrome 148

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

  • runAt

    RunAt opcional

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

RunAt

Chrome 44+ browser.* desde o Chrome 148

O momento mais rápido em que o JavaScript ou CSS será injetado na guia.

Enumeração

"document_start"
O script é injetado depois de 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 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 acionamento do evento window.onload. O momento exato da injeção depende da complexidade do documento e do tempo de carregamento, além de ser 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 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 disparado usando a propriedade document.readyState.