chrome.extensionTypes

Descrição

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

Tipos

CSSOrigin

Chrome 66 ou mais recente

A origin do CSS injetado.

Tipo enumerado

DeleteInjectionDetails

Chrome 87 ou mais recente

Detalhes do CSS a ser removido. O código ou a propriedade do arquivo precisam ser definidos, mas não podem ser definidos 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 forem 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 origin do CSS a ser removido. O valor padrão é "author".

  • arquivo

    string opcional

    Arquivo CSS a ser removido.

  • frameId

    número opcional

    O frame de onde o CSS deve 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, é false.

DocumentLifecycle

Chrome 106 ou mais recente

O ciclo de vida do documento do frame.

Tipo enumerado

ExecutionWorld

Chrome 111 ou mais recente

O mundo em JavaScript onde 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 de usuário que esteja disponível somente para scripts registrados na API User Scripts.

Tipo enumerado

"USER_SCRIPT"

FrameType

Chrome 106 ou mais recente

É o tipo de frame.

Tipo enumerado

.

"fenced_frame"

"sub_frame"

ImageDetails

Detalhes sobre o formato e a qualidade de uma imagem.

Propriedades

  • formato

    ImageFormat opcional

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

  • quality

    número opcional

    Quando o formato é "jpeg", controla a qualidade da imagem resultante. Esse valor é ignorado para imagens PNG. À medida que a qualidade é reduzida, 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.

Tipo enumerado

"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 podem ser definidos ao mesmo tempo.

Propriedades

  • allFrames

    booleano opcional

    Se allFrames for true, isso indica 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 forem definidos, o código vai ser inserido no frame selecionado e em todos os frames filhos dele.

  • código

    string opcional

    Código CSS ou JavaScript a ser injetado.

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

  • cssOrigin

    CSSOrigin opcional

    Chrome 66 ou mais recente

    A origin do CSS a ser injetado. Só pode ser especificado para CSS, não para JavaScript. O valor 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 deve 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 nos frames about:blank e about:srcdoc se a extensão tiver acesso ao documento pai. Não é possível inserir código em sobre:-frames de nível superior. Por padrão, é false.

  • runAt

    RunAt opcional

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

RunAt

Chrome 44 ou mais recente

Assim que o JavaScript ou CSS será injetado na guia.

Tipo enumerado

"document_start"
O script é injetado depois de qualquer arquivo do 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 do carregamento de sub-recursos, como imagens e frames.

"document_idle"
O navegador escolhe um horário 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 que ele leva para carregar. Além disso, ele é otimizado de acordo com 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. A execução é garantida após a conclusão do DOM. Se um script realmente precisar ser executado após window.onload, a extensão poderá verificar se onload já foi disparado usando a propriedade document.readyState.