chrome.extensionTypes

Descripción

La API de chrome.extensionTypes contiene declaraciones de tipos para las extensiones de Chrome.

Tipos

ColorArray

Chrome 139 y versiones posteriores

Tipo

[número, número, número, número]

CSSOrigin

Chrome 66 y versiones posteriores

Es el origen del CSS insertado.

Enum

"author"

"user"

DeleteInjectionDetails

Chrome 87 y versiones posteriores

Son los detalles del CSS que se quitará. Se debe configurar el código o la propiedad del archivo, pero no ambos al mismo tiempo.

Propiedades

  • allFrames

    booleano opcional

    Si allFrames es true, implica que se debe quitar el CSS de todos los marcos de la página actual. De forma predeterminada, es false y solo se quita del fotograma superior. Si se configuran true y frameId, el código se quita del fotograma seleccionado y de todos sus fotogramas secundarios.

  • código

    cadena opcional

    Es el código CSS que se quitará.

  • cssOrigin

    CSSOrigin opcional

    Es el origen del CSS que se quitará. La configuración predeterminada es "author".

  • archivo

    cadena opcional

    Es el archivo CSS que se quitará.

  • frameId

    número opcional

    Es el marco desde el que se debe quitar el CSS. El valor predeterminado es 0 (el fotograma de nivel superior).

  • matchAboutBlank

    booleano opcional

    Si matchAboutBlank es verdadero, el código también se quita de los marcos about:blank y about:srcdoc si tu extensión tiene acceso a su documento principal. De forma predeterminada, es false.

DocumentLifecycle

Chrome 106 y versiones posteriores

Es el ciclo de vida del documento del fotograma.

Enum

"prerender"

"active"

"cached"

"pending_deletion"

ExecutionWorld

Chrome 111 y versiones posteriores

Es el entorno de JavaScript en el que se ejecutará un script. Puede ser un mundo aislado exclusivo de esta extensión, el mundo principal del DOM que se comparte con el JavaScript de la página o un mundo de secuencias de comandos del usuario que solo está disponible para las secuencias de comandos registradas con la API de User Scripts.

Enum

"ISOLATED"

"MAIN"

"USER_SCRIPT"

FrameType

Chrome 106 y versiones posteriores

Es el tipo de fotograma.

Enum

"outermost_frame"

"fenced_frame"

"sub_frame"

ImageDataType

Chrome 139 y versiones posteriores

Son los datos de píxeles de una imagen. Debe ser un objeto ImageData, por ejemplo, de un elemento canvas.

Tipo

ImageData

ImageDetails

Son detalles sobre el formato, la calidad y el área de una imagen.

Propiedades

  • formato

    ImageFormat opcional

    Es el formato de la imagen resultante. El valor predeterminado es "jpeg".

  • calidad

    número opcional

    Cuando el formato es "jpeg", controla la calidad de la imagen resultante. Este valor se ignora para las imágenes PNG. A medida que disminuye la calidad, la imagen resultante tendrá más artefactos visuales y la cantidad de bytes necesarios para almacenarla disminuirá.

ImageFormat

Chrome 44 y versiones posteriores

Es el formato de una imagen.

Enum

"jpeg"

"png"

InjectDetails

Son los detalles de la secuencia de comandos o el CSS que se insertarán. Se debe configurar el código o la propiedad del archivo, pero no ambos al mismo tiempo.

Propiedades

  • allFrames

    booleano opcional

    Si allFrames es true, implica que el código JavaScript o CSS se debe insertar en todos los marcos de la página actual. De forma predeterminada, es false y solo se inyecta en el marco superior. Si se configuran true y frameId, el código se inserta en el fotograma seleccionado y en todos sus fotogramas secundarios.

  • código

    cadena opcional

    Es el código de JavaScript o CSS que se insertará.

    Advertencia: Ten cuidado cuando uses el parámetro code. El uso incorrecto puede exponer tu extensión a ataques de secuencias de comandos entre sitios.

  • cssOrigin

    CSSOrigin opcional

    Chrome 66 y versiones posteriores

    Es el origen del CSS que se insertará. Solo se puede especificar para CSS, no para JavaScript. La configuración predeterminada es "author".

  • archivo

    cadena opcional

    Archivo CSS o JavaScript que se inyectará.

  • frameId

    número opcional

    Chrome 50 y versiones posteriores

    Es el marco en el que se debe insertar la secuencia de comandos o el CSS. El valor predeterminado es 0 (el fotograma de nivel superior).

  • matchAboutBlank

    booleano opcional

    Si matchAboutBlank es verdadero, el código también se inyecta en los marcos about:blank y about:srcdoc si tu extensión tiene acceso a su documento principal. No se puede insertar código en los about:-frames de nivel superior. De forma predeterminada, es false.

  • runAt

    RunAt opcional

    Es el momento más cercano en el que se inyectará el código JavaScript o CSS en la pestaña. El valor predeterminado es "document_idle".

RunAt

Chrome 44 y versiones posteriores

Es el momento más cercano en el que se inyectará el código JavaScript o CSS en la pestaña.

Enum

"document_start"
La secuencia de comandos se inserta después de cualquier archivo de CSS, pero antes de que se construya cualquier otro DOM o se ejecute cualquier otra secuencia de comandos.

"document_end"
La secuencia de comandos se inyecta inmediatamente después de que se completa el DOM, pero antes de que se carguen los recursos secundarios, como imágenes y marcos.

"document_idle"
El navegador elige un momento para insertar la secuencia de comandos entre "document_end" y justo después de que se active el evento window.onload. El momento exacto de la inserción depende de la complejidad del documento y del tiempo que tarda en cargarse, y se optimiza para la velocidad de carga de la página. Las secuencias de comandos de contenido que se ejecutan en "document_idle" no necesitan escuchar el evento window.onload, ya que se garantiza que se ejecutarán después de que se complete el DOM. Si una secuencia de comandos definitivamente debe ejecutarse después de window.onload, la extensión puede verificar si onload ya se activó con la propiedad document.readyState.