browser.extension

Descripción

La API de chrome.extension tiene utilidades que puede usar cualquier página de extensión. Incluye compatibilidad para intercambiar mensajes entre una extensión y sus secuencias de comandos de contenido o entre extensiones, como se describe en detalle en Paso de mensajes.

Tipos

ViewType

Chrome 44 y versiones posteriores browser.* desde Chrome 148

Es el tipo de vista de la extensión.

Enum

"tab"

"popup"

Propiedades

inIncognitoContext

Es verdadero para las secuencias de comandos de contenido que se ejecutan dentro de las pestañas de incógnito y para las páginas de extensiones que se ejecutan dentro de un proceso de incógnito. Esto último solo se aplica a las extensiones con incognito_behavior "dividido".

Tipo

booleano

Métodos

getBackgroundPage()

Solo en primer plano 
browser.extension.getBackgroundPage(): Window | undefined

Devuelve el objeto "window" de JavaScript para la página en segundo plano que se ejecuta dentro de la extensión actual. Muestra un valor nulo si la extensión no tiene una página en segundo plano.

Muestra

  • Ventana | indefinida

getViews()

Solo en primer plano 
browser.extension.getViews(
  fetchProperties?: object,
): Window[]

Devuelve un array de los objetos "window" de JavaScript para cada una de las páginas que se ejecutan dentro de la extensión actual.

Parámetros

  • fetchProperties

    objeto opcional

    • tabId

      number opcional

      Chrome 54 y versiones posteriores browser.* desde Chrome 148

      Busca una vista según un ID de pestaña. Si se omite este campo, se devuelven todas las vistas.

    • tipo

      ViewType opcional

      Es el tipo de vista que se obtendrá. Si se omite, se devuelven todas las vistas (incluidas las páginas y pestañas en segundo plano).

    • windowId

      number opcional

      Es la ventana a la que se restringirá la búsqueda. Si se omite, se devuelven todas las vistas.

Muestra

  • Window[]

    Array de objetos globales

isAllowedFileSchemeAccess()

browser.extension.isAllowedFileSchemeAccess(): Promise<boolean>

Recupera el estado del acceso de la extensión al esquema "file://". Esto corresponde al parámetro de configuración "Permitir acceso a las URLs de archivo" por extensión controlado por el usuario, al que se puede acceder a través de la página chrome://extensions.

Muestra

  • Promise<boolean>

    Chrome 99 y versiones posteriores browser.* desde Chrome 148

isAllowedIncognitoAccess()

browser.extension.isAllowedIncognitoAccess(): Promise<boolean>

Recupera el estado del acceso de la extensión al modo Incógnito. Esto corresponde al parámetro de configuración "Permitir en modo Incógnito" controlado por el usuario para cada extensión, al que se puede acceder a través de la página chrome://extensions.

Muestra

  • Promise<boolean>

    Chrome 99 y versiones posteriores browser.* desde Chrome 148

setUpdateUrlData()

browser.extension.setUpdateUrlData(
  data: string,
): void

Establece el valor del parámetro CGI ap que se usa en la URL de actualización de la extensión. Este valor se ignora para las extensiones que se alojan en la galería de extensiones de Chrome.

Parámetros

  • datos

    string