chrome.extension

Descripción

La API de chrome.extension tiene utilidades que pueden usar todas las páginas de extensiones. Incluye compatibilidad con el intercambio de 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

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 en pestañas de incógnito y para las páginas de extensión que se ejecutan en un proceso de incógnito. Esto último solo se aplica a las extensiones con incognito_behavior "split".

Tipo

booleano

Métodos

getBackgroundPage()

Solo en primer plano 
chrome.extension.getBackgroundPage()

Muestra 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 | sin definir

getViews()

Solo en primer plano 
chrome.extension.getViews(
  fetchProperties?: object,
)

Muestra 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

      número opcional

      Chrome 54 y versiones posteriores

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

    • tipo

      ViewType opcional

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

    • windowId

      número opcional

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

Muestra

  • Ventana[]

    Array de objetos globales

isAllowedFileSchemeAccess()

Promesa 
chrome.extension.isAllowedFileSchemeAccess(
  callback?: function,
)

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

Parámetros

  • callback

    función opcional

    El parámetro callback se ve de la siguiente manera: 

    (isAllowedAccess: boolean) => void

    • isAllowedAccess

      booleano

      Es verdadero si la extensión puede acceder al esquema "file://"; de lo contrario, es falso.

Muestra

  • Promesa<booleano>

    Chrome 99 y versiones posteriores

    Las promesas son compatibles con el manifiesto V3 y versiones posteriores, pero se proporcionan devoluciones de llamada para la retrocompatibilidad. No puedes usar ambos en la misma llamada a función. La promesa se resuelve con el mismo tipo que se pasa a la devolución de llamada.

isAllowedIncognitoAccess()

Promesa 
chrome.extension.isAllowedIncognitoAccess(
  callback?: function,
)

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

Parámetros

  • callback

    función opcional

    El parámetro callback se ve de la siguiente manera: 

    (isAllowedAccess: boolean) => void

    • isAllowedAccess

      booleano

      Es verdadero si la extensión tiene acceso al modo Incógnito; de lo contrario, es falso.

Muestra

  • Promesa<booleano>

    Chrome 99 y versiones posteriores

    Las promesas son compatibles con el manifiesto V3 y versiones posteriores, pero se proporcionan devoluciones de llamada para la retrocompatibilidad. No puedes usar ambos en la misma llamada a función. La promesa se resuelve con el mismo tipo que se pasa a la devolución de llamada.

setUpdateUrlData()

chrome.extension.setUpdateUrlData(
  data: string,
)

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

Parámetros

  • datos

    string

Eventos