chrome.webviewTag

Propriedades

• desde que

  número opcional

  Limpa os dados acumulados a partir dessa data, representados em milissegundos desde a época (acessível pelo método getTime do objeto JavaScript Date). Se ausente, o padrão é 0 (o que remove todos os dados de navegação).

Propriedades

• cache de app

  booleano opcional

  Sites caches de aplicativos.

• cache

  booleano opcional

  Chrome 44 ou superior

  Desde o Chrome 43. O cache do navegador. Observação: ao remover dados, todo o cache será limpo. ele não se limita ao intervalo que você especifica.

• cookies

  booleano opcional

  Os cookies da partição.

• fileSystems

  booleano opcional

  Sites nos sistemas de arquivos.

• indexedDB

  booleano opcional

  Sites Dados do IndexedDB.

• localStorage

  booleano opcional

  Sites dados de armazenamento local.

• persistentCookies

  booleano opcional

  Chrome 58 ou superior

  Os cookies persistentes da partição.

• sessionCookies

  booleano opcional

  Chrome 58 ou superior

  Os cookies de sessão da partição.

• webSQL

  booleano opcional

  Sites dados do WebSQL.

Propriedades

• all_frames

  booleano opcional

  Se all_frames for true, isso significa que o JavaScript ou CSS precisa ser injetado em todos os frames da página atual. Por padrão, all_frames é false, e o JavaScript ou CSS só é injetado no frame superior.

• css

  InjectionItems opcional

  O código CSS ou uma lista de arquivos CSS a serem injetados em páginas correspondentes. Eles são injetados na ordem em que aparecem, antes de qualquer DOM ser construído ou exibido para a página.

• exclude_globs

  string[] opcional

  Aplicado após as correspondências para excluir URLs que correspondem a este glob. Destina-se a emular a palavra-chave @exclude Greasemonkey.

• exclude_matches

  string[] opcional

  Exclui páginas em que esse script de conteúdo seria injetado de outra forma.

• include_globs

  string[] opcional

  Aplicado após as correspondências para incluir apenas os URLs que também correspondem a este glob. que serve para emular a palavra-chave @include Greasemonkey.

• js

  InjectionItems opcional

  O código JavaScript ou uma lista de arquivos JavaScript a serem injetados em páginas correspondentes. Eles são injetados na ordem em que aparecem.

• match_about_blank

  booleano opcional

  Define se o script de conteúdo será inserido em about:blank e about:srcdoc. Os scripts de conteúdo só serão injetados em páginas quando o URL herdado corresponder a um dos padrões declarados no campo de correspondências. O URL herdado é o URL do documento que criou o frame ou a janela. Não é possível inserir scripts de conteúdo em frames no modo sandbox.

• correspondências

  string[]

  Especifica em quais páginas esse script de conteúdo será injetado.

• nome

  string

  O nome do script de conteúdo a ser injetado.

• run_at

  RunAt opcional

  Assim que o JavaScript ou CSS for injetado na guia o mais rápido possível. O padrão é "document_idle".

Propriedades

• postMessage

  void

  Posta uma mensagem no conteúdo da Web incorporado, desde que esse conteúdo mostre uma página da origem de destino. Esse método estará disponível após a conclusão do carregamento da página. Detecte o evento contentload e chame o método.

  O convidado poderá enviar respostas ao incorporador postando mensagens em event.source no evento de mensagem recebido.

  Essa API é idêntica à API HTML5 postMessage (link em inglês) para comunicação entre páginas da Web. O incorporador pode detectar respostas adicionando um listener de eventos message ao próprio frame.

  A função postMessage tem esta aparência:

  (message: any, targetOrigin: string) => {...}

  • mensagem

    qualquer um

    Objeto de mensagem a ser enviado ao convidado.

  • targetOrigin

    string

    Especifica a origem da janela de convidados para que o evento seja despachado.

Propriedades

• marcado

  booleano opcional

  O estado inicial de uma caixa de seleção ou item de opção: "true" para os selecionados e "false" para os não selecionados. Somente um item de opção pode ser selecionado por vez em um determinado grupo de itens de opção.

• contexts

  [ContextType, ...ContextType[]] opcional

  Lista de contextos em que este item de menu vai aparecer. Se nada for especificado, o padrão será ['page'].

• documentUrlPatterns

  string[] opcional

  Permite que você restrinja o item para que seja aplicado apenas a documentos com um URL que corresponda a um dos padrões fornecidos. Isso também se aplica a frames. Para detalhes sobre o formato de um padrão, consulte Corresponder padrões.

• ativado

  booleano opcional

  Indica se esse item do menu de contexto está ativado ou desativado. O valor padrão é true.

• id

  string opcional

  O ID exclusivo a ser atribuído a este item. Obrigatório para páginas de eventos. Não pode ser igual a outro ID desta extensão.

• parentId

  string | número opcional

  O ID de um item de menu pai. isso torna o item um item filho de um item adicionado anteriormente.

• targetUrlPatterns

  string[] opcional

  Semelhante a documentUrlPatterns, mas permite filtrar com base no atributo src das tags img/audio/video e no href das tags âncora.

• título

  string opcional

  O texto a ser exibido no item. Isso é obrigatório, a menos que type seja "separator". Quando o contexto for "seleção", é possível usar %s na string para mostrar o texto selecionado. Por exemplo, se o valor desse parâmetro for "Translate '%s' ao Pig Latin" e o usuário selecionar a palavra "cool" (legal), o item do menu de contexto para seleção será "traduzir 'legal'". ao Pig Latin".

• tipo

  ItemType opcional

  Tipo de item de menu. O padrão é "normal" caso não seja especificado.

• clique

  void opcional

  Uma função que será chamada de volta quando o item de menu for clicado.

  A função onclick tem esta aparência:

  (info: OnClickData) => {...}

  • informações

    OnClickData

    As informações sobre o item clicado e o contexto em que ele ocorreu.

Propriedades

• onShow

  Evento<functionvoidvoid>

  Disparado antes de mostrar um menu de contexto neste webview. Pode ser usado para desativar esse menu de contexto chamando event.preventDefault().

  A função onShow.addListener tem esta aparência:

  (callback: function) => {...}

  • callback

    função

    O parâmetro callback tem esta aparência:

    (event: object) => void

    • evento

      objeto

      • preventDefault

        void

        Chame essa função para evitar a exibição do menu de contexto.

        A função preventDefault tem esta aparência:

        () => {...}

• create

  void

  Cria um novo item de menu de contexto. Se ocorrer um erro durante a criação, talvez você não descubra até que o callback de criação seja disparado (os detalhes estarão em runtime.lastError).

  A função create tem esta aparência:

  (createProperties: object, callback?: function) => {...}

  • createProperties

    objeto

    Propriedades usadas para criar o item.

  • callback

    função opcional

    O parâmetro callback tem esta aparência:

    () => void

  • retorna

    string | número

    ID do item recém-criado.

• remover

  void

  Remove um item de menu de contexto.

  A função remove tem esta aparência:

  (menuItemId: string | number, callback?: function) => {...}

  • menuItemId

    string | número

    O ID do item do menu de contexto a ser removido.

  • callback

    função opcional

    O parâmetro callback tem esta aparência:

    () => void

• removeAll

  void

  Remove todos os itens do menu de contexto adicionados a este webview.

  A função removeAll tem esta aparência:

  (callback?: function) => {...}

  • callback

    função opcional

    O parâmetro callback tem esta aparência:

    () => void

• update

  void

  Atualiza um item de menu de contexto criado anteriormente.

  A função update tem esta aparência:

  (id: string | number, updateProperties: object, callback?: function) => {...}

  • id

    string | número

    ID do item a ser atualizado.

  • updateProperties

    objeto

    As propriedades a serem atualizadas. Aceita os mesmos valores da função de criação.

  • callback

    função opcional

    O parâmetro callback tem esta aparência:

    () => void

Propriedades

• marcado

  booleano opcional

  O estado de uma caixa de seleção ou item de opção: "true" para os selecionados e "false" para os não selecionados. Somente um item de opção pode ser selecionado por vez em um determinado grupo de itens de opção.

• contexts

  [ContextType, ...ContextType[]] opcional

  Lista de contextos em que este item de menu vai aparecer.

• documentUrlPatterns

  string[] opcional

  Permite que você restrinja o item para que seja aplicado apenas a documentos com um URL que corresponda a um dos padrões fornecidos. Isso também se aplica a frames. Para detalhes sobre o formato de um padrão, consulte Corresponder padrões.

• ativado

  booleano opcional

  Indica se esse item do menu de contexto está ativado ou desativado.

• parentId

  string | número opcional

  O ID de um item de menu pai. isso torna o item um item filho de um item adicionado anteriormente. Observação:não é possível alterar um item para ser filho de um dos próprios descendentes.

• targetUrlPatterns

  string[] opcional

  Semelhante a documentUrlPatterns, mas permite filtrar com base no atributo src das tags img/audio/video e no href das tags âncora.

• título

  string opcional

  O texto a ser exibido no item

• tipo

  ItemType opcional

  Tipo de item de menu.

• clique

  void opcional

  Uma função que será chamada de volta quando o item de menu for clicado.

  A função onclick tem esta aparência:

  (info: OnClickData) => {...}

  • informações

    OnClickData

    As informações sobre o item clicado e o contexto em que ele ocorreu.

Enumeração

Propriedades

• cancelar

  void

  Rejeitar a caixa de diálogo. É equivalente a clicar em "Cancelar" em uma caixa de diálogo confirm ou prompt.

  A função cancel tem esta aparência:

  () => {...}

• ok

  void

  Aceite a caixa de diálogo. Equivalente a clicar em OK em uma caixa de diálogo alert, confirm ou prompt.

  A função ok tem esta aparência:

  (response?: string) => {...}

  • resposta

    string opcional

    A string de resposta a ser fornecida ao convidado ao aceitar uma caixa de diálogo prompt.

Propriedades

• requestMethod

  string

  O tipo de solicitação HTTP (por exemplo, GET) associado à solicitação de download.

• url

  string

  O URL de download solicitado.

• allow

  void

  Conceda a solicitação de permissão.

  A função allow tem esta aparência:

  () => {...}

• deny

  void

  negue a solicitação de permissão. Esse será o comportamento padrão se allow não for chamado.

  A função deny tem esta aparência:

  () => {...}

Propriedades

• url

  string

  O URL do frame que solicita acesso ao sistema de arquivos local.

• allow

  void

  Conceda a solicitação de permissão.

  A função allow tem esta aparência:

  () => {...}

• deny

  void

  negue a solicitação de permissão.

  A função deny tem esta aparência:

  () => {...}

Propriedades

• activeMatchOrdinal

  number

  O número ordinal da correspondência atual.

• cancelada

  booleano

  Indica se essa solicitação de localização foi cancelada.

• numberOfMatches

  number

  O número de vezes que searchText foi correspondido na página.

• selectionRect

  SelectionRect

  Descreve um retângulo ao redor da correspondência ativa nas coordenadas da tela.

Propriedades

• para trás

  booleano opcional

  Sinalize para encontrar correspondências na ordem inversa. O valor padrão é false.

• matchCase

  booleano opcional

  Sinalização que corresponde à diferenciação entre maiúsculas e minúsculas. O valor padrão é false.

Propriedades

• origem

  string

  A origem do frame dentro do webview que iniciou a solicitação de tela cheia.

• allow

  void

  Conceda a solicitação de permissão.

  A função allow tem esta aparência:

  () => {...}

• deny

  void

  negue a solicitação de permissão.

  A função deny tem esta aparência:

  () => {...}

Propriedades

• url

  string

  O URL do frame que solicita acesso aos dados de geolocalização.

• allow

  void

  Conceda a solicitação de permissão.

  A função allow tem esta aparência:

  () => {...}

• deny

  void

  negue a solicitação de permissão. Esse será o comportamento padrão se allow não for chamado.

  A função deny tem esta aparência:

  () => {...}

Propriedades

• url

  string

  O URL do frame que solicita acesso à API HID.

• allow

  void

  Conceda a solicitação de permissão.

  A função allow tem esta aparência:

  () => {...}

• deny

  void

  negue a solicitação de permissão. Esse será o comportamento padrão se allow não for chamado.

  A função deny tem esta aparência:

  () => {...}

Propriedades

• código

  string opcional

  código JavaScript ou CSS a ser injetado.

  Aviso: Tenha cuidado ao usar o parâmetro code. O uso incorreto dela pode deixar o app vulnerável a ataques de scripting em vários locais.

• arquivo

  string opcional

  JavaScript ou CSS a ser injetado.

Propriedades

• código

  string opcional

  código JavaScript ou CSS a ser injetado em páginas correspondentes.

• arquivos

  string[] opcional

  A lista de arquivos JavaScript ou CSS a serem injetados em páginas correspondentes. Eles são injetados na ordem em que aparecem nesta matriz.

Propriedades

• identificador

  string

  String do identificador do plug-in.

• nome

  string

  O nome de exibição do plug-in.

• allow

  void

  Conceda a solicitação de permissão. Esse será o comportamento padrão se deny não for chamado.

  A função allow tem esta aparência:

  () => {...}

• deny

  void

  negue a solicitação de permissão.

  A função deny tem esta aparência:

  () => {...}

Propriedades

• url

  string

  O URL do frame que solicita acesso à mídia do usuário.

• allow

  void

  Conceda a solicitação de permissão.

  A função allow tem esta aparência:

  () => {...}

• deny

  void

  negue a solicitação de permissão. Esse será o comportamento padrão se allow não for chamado.

  A função deny tem esta aparência:

  () => {...}

Propriedades

• anexar

  void

  Anexar a página de destino solicitada a um elemento webview existente.

  A função attach tem esta aparência:

  (webview: object) => {...}

  • WebView

    objeto

    O elemento webview ao qual a página de destino será anexada.

• descartar

  void

  Cancele a solicitação de nova janela.

  A função discard tem esta aparência:

  () => {...}

Propriedades

• lastUnlockedBySelf

  booleano

  Se o frame solicitante foi ou não o cliente mais recente a manter o bloqueio de ponteiro.

• url

  string

  O URL do frame que solicita o bloqueio do ponteiro.

• userGesture

  booleano

  Se o bloqueio do ponteiro foi solicitado como resultado de um gesto de entrada do usuário.

• allow

  void

  Conceda a solicitação de permissão.

  A função allow tem esta aparência:

  () => {...}

• deny

  void

  negue a solicitação de permissão. Esse será o comportamento padrão se allow não for chamado.

  A função deny tem esta aparência:

  () => {...}

Propriedades

• altura

  number

  Altura do retângulo.

• esquerda

  number

  Distância da borda esquerda da tela até a borda esquerda do retângulo.

• superior

  number

  Distância da borda superior da tela até a borda superior do retângulo.

• largura

  number

  Largura do retângulo.

Enumeração

Tipo

Tipo

Tipo

Parâmetros

• contentScriptList

  [ContentScriptDetails, ...ContentScriptDetails[]]

  Detalhes dos scripts de conteúdo a serem adicionados.

Parâmetros

• callback

  função opcional

  Chrome 44 ou superior

  O parâmetro callback tem esta aparência:

  (success: boolean) => void

  • sucesso

    booleano

    Indica se a navegação foi bem-sucedida.

Retorna

• booleano

Retorna

• booleano

Parâmetros

• opções

  ImageDetails opcional

• callback

  função

  O parâmetro callback tem esta aparência:

  (dataUrl: string) => void

  • dataUrl

    string

    Um URL de dados que codifica uma imagem da área visível da guia capturada. Pode ser atribuído ao "src" de um elemento de imagem HTML para exibição.

Parâmetros

• opções

  ClearDataOptions

  Opções que determinam quais dados limpar.

• tipos

  ClearDataTypeSet

  Os tipos de dados a serem apagados.

• callback

  função opcional

  O parâmetro callback tem esta aparência:

  () => void

Parâmetros

• detalhes

  InjectDetails

  Detalhes do script a ser executado.

• callback

  função opcional

  O parâmetro callback tem esta aparência:

  (result?: any[]) => void

  • resultado

    any[] opcional

    O resultado do script em cada frame injetado

Parâmetros

• searchText

  string

  A string a ser encontrada na página.

• opções

  FindOptions opcional

  Opções para a solicitação de localização.

• callback

  função opcional

  O parâmetro callback tem esta aparência:

  (results?: FindCallbackResults) => void

  • resultados

    FindCallbackResults opcional

    Contém todos os resultados da solicitação de localização. results pode ser omitido se não for utilizado no corpo da função de callback. por exemplo, se o callback for usado apenas para saber quando a solicitação de localização foi concluída.

Parâmetros

• callback

  função opcional

  Chrome 44 ou superior

  O parâmetro callback tem esta aparência:

  (success: boolean) => void

  • sucesso

    booleano

    Indica se a navegação foi bem-sucedida.

Parâmetros

• callback

  função

  O parâmetro callback tem esta aparência:

  (audible: boolean) => void

  • Audible

    booleano

Retorna

• number

Retorna

• string

Parâmetros

• callback

  função

  O parâmetro callback tem esta aparência:

  (zoomFactor: number) => void

  • zoomFactor

    number

    O fator de zoom atual.

Parâmetros

• callback

  função

  O parâmetro callback tem esta aparência:

  (ZoomMode: ZoomMode) => void

  • ZoomMode

    ZoomMode

    O modo de zoom atual do webview.

Parâmetros

• relativeIndex

  number

  Índice de histórico relativo para onde o webview precisa ser navegado. Por exemplo, o valor 2 faz com que duas entradas do histórico sejam encaminhadas, se possível. um valor de -3 vai navegar pelas três entradas anteriores.

• callback

  função opcional

  O parâmetro callback tem esta aparência:

  (success: boolean) => void

  • sucesso

    booleano

    Indica se a navegação foi bem-sucedida.

Parâmetros

• detalhes

  InjectDetails

  Detalhes do CSS a ser inserido.

• callback

  função opcional

  O parâmetro callback tem esta aparência:

  () => void

Parâmetros

• callback

  função

  O parâmetro callback tem esta aparência:

  (muted: boolean) => void

  • silenciado

    booleano

Parâmetros

• callback

  função

  O parâmetro callback tem esta aparência:

  (enabled: boolean) => void

  • ativado

    booleano

Parâmetros

• dataUrl

  string

  O URL de dados a ser carregado.

• baseUrl

  string

  O URL base que será usado para links relativos.

• virtualUrl

  string opcional

  O URL que será exibido para o usuário (na barra de endereço).

Parâmetros

• scriptNameList

  string[] opcional

  Uma lista de nomes dos scripts de conteúdo que serão removidos. Se a lista estiver vazia, todos os scripts de conteúdo adicionados ao webview serão removidos.

Parâmetros

• desativar som

  booleano

  Valor do som do áudio

Parâmetros

• ativado

  booleano

  Valor do estado de navegação espacial.

Parâmetros

• userAgent

  string

  A string do user agent a ser usada.

Parâmetros

• zoomFactor

  number

  O novo fator de zoom.

• callback

  função opcional

  O parâmetro callback tem esta aparência:

  () => void

Parâmetros

• ZoomMode

  ZoomMode

  Define como o zoom é processado no webview.

• callback

  função opcional

  O parâmetro callback tem esta aparência:

  () => void

Parâmetros

• ação

  "limpar"
   | "manter"
   | "ativar"
   opcional

  Determina o que fazer com a correspondência ativa após o término da sessão de localização. clear vai limpar o destaque sobre a correspondência ativa. keep vai manter a correspondência ativa em destaque; activate vai manter a correspondência ativa destacada e simular um clique do usuário nela. A ação padrão é keep.

Parâmetros

• callback

  função

  O parâmetro callback tem esta aparência:

  () => void

Parâmetros

• callback

  função

  O parâmetro callback tem esta aparência:

  (level: number, message: string, line: number, sourceId: string) => void

  • level

    number

  • mensagem

    string

  • linha

    number

  • sourceId

    string

Parâmetros

• callback

  função

  O parâmetro callback tem esta aparência:

  () => void

Parâmetros

• callback

  função

  O parâmetro callback tem esta aparência:

  (messageType: "alert" 
    | "confirm" 
    | "prompt" 
   , messageText: string, dialog: DialogController) => void

  • messageType

    "alerta"
     | "confirmar"
     | "prompt"
    

  • messageText

    string

  • caixa de diálogo

    DialogController

Parâmetros

• callback

  função

  O parâmetro callback tem esta aparência:

  (processID: number, reason: "normal" 
    | "abnormal" 
    | "crash" 
    | "kill" 
   ) => void

  • processID

    number

  • reason

    "normal"
     | "abnormal"
     | "falha"
     | "kill"
    

Parâmetros

• callback

  função

  O parâmetro callback tem esta aparência:

  (searchText: string, numberOfMatches: number, activeMatchOrdinal: number, selectionRect: SelectionRect, canceled: boolean, finalUpdate: string) => void

  • searchText

    string

  • numberOfMatches

    number

  • activeMatchOrdinal

    number

  • selectionRect

    SelectionRect

  • cancelada

    booleano

  • finalUpdate

    string

Parâmetros

• callback

  função

  O parâmetro callback tem esta aparência:

  (url: string, isTopLevel: boolean, code: number, reason: "ERR_ABORTED" 
    | "ERR_INVALID_URL" 
    | "ERR_DISALLOWED_URL_SCHEME" 
    | "ERR_BLOCKED_BY_CLIENT" 
    | "ERR_ADDRESS_UNREACHABLE" 
    | "ERR_EMPTY_RESPONSE" 
    | "ERR_FILE_NOT_FOUND" 
    | "ERR_UNKNOWN_URL_SCHEME" 
   ) => void

  • url

    string

  • isTopLevel

    booleano

  • código

    number

  • reason

    "ERR_ABORTED"
     | &quot;ERR_INVALID_URL&quot;
     | &quot;ERR_DISALLOWED_URL_SCHEME&quot;
     | &quot;ERR_BLOCKED_BY_CLIENT&quot;
     | "ERR_ADDRESS_UNREACHABLE"
     | &quot;ERR_EMPTY_RESPONSE&quot;
     | &quot;ERR_FILE_NOT_FOUND&quot;
     | &quot;ERR_UNKNOWN_URL_SCHEME&quot;
    

Parâmetros

• callback

  função

  O parâmetro callback tem esta aparência:

  (url: string, isTopLevel: boolean) => void

  • url

    string

  • isTopLevel

    booleano

Parâmetros

• callback

  função

  O parâmetro callback tem esta aparência:

  (oldUrl: string, newUrl: string, isTopLevel: boolean) => void

  • oldUrl

    string

  • newUrl

    string

  • isTopLevel

    booleano

Parâmetros

• callback

  função

  O parâmetro callback tem esta aparência:

  (url: string, isTopLevel: boolean) => void

  • url

    string

  • isTopLevel

    booleano

Parâmetros

• callback

  função

  O parâmetro callback tem esta aparência:

  () => void

Parâmetros

• callback

  função

  O parâmetro callback tem esta aparência:

  (window: NewWindow, targetUrl: string, initialWidth: number, initialHeight: number, name: string, windowOpenDisposition: "ignore" 
    | "save_to_disk" 
    | "current_tab" 
    | "new_background_tab" 
    | "new_foreground_tab" 
    | "new_window" 
    | "new_popup" 
   ) => void

  • janela

    NewWindow

  • targetUrl

    string

  • initialWidth

    number

  • initialHeight

    number

  • nome

    string

  • windowOpenDisposition

    "ignorar"
     | "save_to_disk"
     | "current_tab"
     | &quot;new_background_tab&quot;
     | "new_foreground_tab"
     | "new_window"
     | "new_popup"
    

Parâmetros

• callback

  função

  O parâmetro callback tem esta aparência:

  (permission: "media" 
    | "geolocation" 
    | "pointerLock" 
    | "download" 
    | "loadplugin" 
    | "filesystem" 
    | "fullscreen" 
    | "hid" 
   , request: object) => void

  • permissão

    "media"
     | "geolocalização"
     | "pointerLock"
     | "download"
     | "loadplugin"
     | "sistema de arquivos"
     | "tela cheia"
     | "oculto"
    

  • solicitação

    objeto

Parâmetros

• callback

  função

  O parâmetro callback tem esta aparência:

  (processID: number) => void

  • processID

    number

Parâmetros

• callback

  função

  O parâmetro callback tem esta aparência:

  (oldWidth: number, oldHeight: number, newWidth: number, newHeight: number) => void

  • oldWidth

    number

  • oldHeight

    number

  • newWidth

    number

  • newHeight

    number

Parâmetros

• callback

  função

  O parâmetro callback tem esta aparência:

  (processID: number) => void

  • processID

    number

Parâmetros

• callback

  função

  O parâmetro callback tem esta aparência:

  (oldZoomFactor: number, newZoomFactor: number) => void

  • oldZoomFactor

    number

  • newZoomFactor

    number