chrome.extensionTypes

Descripción

La API de chrome.extensionTypes contiene declaraciones de tipo para extensiones de Chrome.

Tipos

CSSOrigin

Chrome 66 y versiones posteriores

Es el origen del CSS insertado.

Enum

DeleteInjectionDetails

Chrome 87 y versiones posteriores

Detalles del CSS que se quitará. Se deben 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 marco superior. Si se configuran true y frameId, se quita el código del marco seleccionado y de todos sus marcos secundarios.

  • código

    cadena opcional

    Código CSS que se quitará.

  • cssOrigin

    CSSOrigin opcional

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

  • en el archivo.

    cadena opcional

    Archivo CSS que se quitará.

  • frameId

    número opcional

    Es el marco del que se debe quitar el CSS. La configuración predeterminada es 0 (el marco 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 la extensión tiene acceso a su documento superior. El valor predeterminado es false.

DocumentLifecycle

Chrome 106 y versiones posteriores

Es el ciclo de vida del documento del marco.

Enum

ExecutionWorld

Chrome 111 y versiones posteriores

El mundo de JavaScript en el que se ejecuta una secuencia de comandos. Puede ser un mundo aislado único 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 de usuario que solo está disponible para las secuencias de comandos registradas con la API de User Scripts.

Enum

"USER_SCRIPT"

FrameType

Chrome 106 y versiones posteriores

Es el tipo de marco.

Enum

"fenced_frame"

"sub_frame"

ImageDetails

Detalles sobre el formato y la calidad de una imagen.

Propiedades

  • formato

    ImageFormat opcional

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

  • quality

    número opcional

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

ImageFormat

Chrome 44 y versiones posteriores

Es el formato de una imagen.

Enum

"png"

InjectDetails

Detalles de la secuencia de comandos o CSS que se insertarán. Se deben 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 JavaScript o CSS debe insertarse en todos los marcos de la página actual. De forma predeterminada, es false y solo se inserta en el marco superior. Si se configuran true y frameId, el código se inserta en el marco seleccionado y en todos sus marcos secundarios.

  • código

    cadena opcional

    Código JavaScript o CSS para insertar.

    Advertencia: Ten cuidado cuando uses el parámetro code. Si la usas de forma incorrecta, es posible que tu extensión se abra frente a ataques de secuencia 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".

  • en el archivo.

    cadena opcional

    Archivo JavaScript o CSS para insertar.

  • frameId

    número opcional

    Chrome 50 y versiones posteriores

    El marco en el que se debe insertar la secuencia de comandos o CSS La configuración predeterminada es 0 (el marco de nivel superior).

  • matchAboutBlank

    booleano opcional

    Si matchAboutBlank es verdadero, el código también se inserta en los marcos about:blank y about:srcdoc si la extensión tiene acceso a su documento superior. No se puede insertar el código en el nivel superior about:-frames. El valor predeterminado es false.

  • runAt

    RunAt opcional

    En cuanto se inserte JavaScript o CSS en la pestaña, lo más pronto posible. La configuración predeterminada es “document_idle”.

RunAt

Chrome 44 y versiones posteriores

En cuanto se inserte JavaScript o CSS en la pestaña, lo más pronto posible.

Enum

"document_start"
La secuencia de comandos se inserta después de los archivos 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 inserta inmediatamente después de que se completa el DOM, pero antes de que se carguen los subrecursos, como las imágenes y los marcos.

"document_idle"
El navegador elige un momento para insertar la secuencia de comandos entre "document_end" e inmediatamente después de que se activa el evento window.onload. El momento exacto de la inyección depende de qué tan complejo sea el documento y cuánto tarde en cargarse; además, está optimizado para la velocidad de carga de la página. Las secuencias de comandos de contenido que se ejecutan en "document_idle" no necesitan detectar el evento window.onload; se garantiza que se ejecutarán una vez que se complete el DOM. Si sin dudas se debe ejecutar una secuencia de comandos después de window.onload, la extensión puede verificar si onload ya se activó con la propiedad document.readyState.