Esta tradução está incompleta. Por favor, ajude a traduzir este artigo.

Use esta API para registrar o conteúdo de scripts. Registrando um conteúdo de scripts instrui o navegador para inserir conteúdo de script fornecido em páginas que batem com um padrão de URL fornecida.

Esta API é muito similar a chave do "content_scripts"  no manifest.json key, exceto pelo  "content_scripts", o conjunto de conteúdo de scripts a padrões associados são fixados no momento da instalação. Com a API contentScripts, uma extensão pode registrar e desregistrar scripts em tempo de execução.

Para usar a API, invoque contentScripts.register() passando um objeto definido para registrar os scripts, os padrões de URL e outras opções. Ele retorna uma Promise que é resolvida com o objeto contentScripts.RegisteredContentScript.

O objeto RegisteredContentScript represente os scripts que foram registrados com a chamada register(). Ele define um método unregister() que você pode usar para desregistrar o conteúdo de scripts. O conteúdo de scripts também são desregistrados automaticamente quando a página que os criou é destruida. Por exemplo, se estão registrados para uma página em segundo plano serão desregistrados automaticamente quando esta página for destruida, e se eles estão registrados para uma barra lateral ou popup, também serão desregistrados automaticamente quando essas forem fechadas.

Não há permissão para a API contentScripts, mas uma extensão pode ter a permissão de host apropriada para algum padrão passado para o register().

Tipos

contentScripts.RegisteredContentScript

Um objeto deste tipo é retornado pela função contentScripts.register() . Ele representa o conteúdo dos scripts que foram registrados por aquela chamada, e podem ser usados para desregistrar o conteúdo do script.

Funções

contentScripts.register()
Registra o conteúdo dos scripts fornecidos.

Compatibilidade do navegador

ChromeEdgeFirefoxFirefox for AndroidOpera
RegisteredContentScript No No5959 No
RegisteredContentScript.unregister No No5959 No
register No No5959 No

 

Example extensions

Etiquetas do documento e colaboradores

Colaboradores desta página: thiagopelizoni
Última atualização por: thiagopelizoni,