Descripción
La API de chrome.extensionTypes
contiene declaraciones de tipo para extensiones de Chrome.
Tipos
Enum
DeleteInjectionDetails
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, esfalse
y solo se quita del marco superior. Si se configurantrue
yframeId
, 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
Es el ciclo de vida del documento del marco.
Enum
FrameType
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
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, esfalse
y solo se inserta en el marco superior. Si se configurantrue
yframeId
, 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 posterioresEs 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 posterioresEl 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
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
.