Descrizione
L'API chrome.extensionTypes
contiene dichiarazioni del tipo per le estensioni di Chrome.
Tipi
Enum
DeleteInjectionDetails
Dettagli del CSS da rimuovere. È necessario impostare il codice o la proprietà del file, ma non possono essere impostati entrambi contemporaneamente.
Proprietà
-
allFrames
booleano facoltativo
Se allFrames è
true
, significa che il CSS deve essere rimosso da tutti i frame della pagina corrente. Per impostazione predefinita èfalse
e viene rimosso solo dal frame superiore. Se vengono impostatitrue
eframeId
, il codice viene rimosso dal frame selezionato e da tutti i relativi frame secondari. -
codice
stringa facoltativo
Codice CSS da rimuovere.
-
cssOrigin
CSSOrigin facoltativo
L'origine del CSS da rimuovere. Il valore predefinito è
"author"
. -
file
stringa facoltativo
File CSS da rimuovere.
-
frameId
numero facoltativo
Il frame da cui rimuovere il CSS. Il valore predefinito è 0 (frame di primo livello).
-
matchAboutBlank
booleano facoltativo
Se matchAboutBlank è true, il codice viene rimosso anche dai frame about:blank e about:srcdoc se l'estensione ha accesso al relativo documento padre. Il valore predefinito è
false
.
DocumentLifecycle
Il ciclo di vita del documento del frame.
Enum
ExecutionWorld
Il mondo JavaScript in cui eseguire uno script. Può essere un mondo isolato univoco per questa estensione, il mondo principale del DOM condiviso con il codice JavaScript della pagina o un mondo di script utente disponibile solo per gli script registrati con l'API User Scripts.
Enum
"USER_SCRIPT"
FrameType
Il tipo di frame.
Enum
"outermost_frame"
"fenced_frame"
"sub_frame"
ImageDetails
Dettagli sul formato e sulla qualità di un'immagine.
Proprietà
-
dell'annuncio
ImageFormat facoltativo
Il formato dell'immagine risultante. Il valore predefinito è
"jpeg"
. -
qualità
numero facoltativo
Se il formato è
"jpeg"
, controlla la qualità dell'immagine risultante. Questo valore viene ignorato per le immagini PNG. Man mano che la qualità diminuisce, l'immagine risultante avrà più artefatti visivi e il numero di byte necessari per archiviarla diminuirà.
ImageFormat
Il formato di un'immagine.
Enum
"jpeg"
"png"
InjectDetails
Dettagli dello script o del CSS da inserire. È necessario impostare il codice o la proprietà del file, ma non possono essere impostati entrambi contemporaneamente.
Proprietà
-
allFrames
booleano facoltativo
Se allFrames è
true
, significa che il codice JavaScript o CSS deve essere inserito in tutti i frame della pagina corrente. Per impostazione predefinita, èfalse
e viene inserito solo nel frame superiore. Se vengono impostatitrue
eframeId
, il codice viene inserito nel frame selezionato e in tutti i relativi frame secondari. -
codice
stringa facoltativo
codice JavaScript o CSS da inserire.
Avviso: fai attenzione a utilizzare il parametro
code
. Un utilizzo non corretto potrebbe comportare l'apertura dell'estensione ad attacchi di cross-site scripting -
cssOrigin
CSSOrigin facoltativo
Chrome 66 e versioni successiveL'origine del CSS da inserire. Può essere specificato solo per il CSS, non per JavaScript. Il valore predefinito è
"author"
. -
file
stringa facoltativo
JavaScript o CSS da inserire.
-
frameId
numero facoltativo
Chrome 50 e versioni successiveIl frame in cui deve essere inserito lo script o il CSS. Il valore predefinito è 0 (frame di primo livello).
-
matchAboutBlank
booleano facoltativo
Se matchAboutBlank è true, il codice viene inserito anche nei frame about:blank e about:srcdoc se l'estensione ha accesso al relativo documento padre. Impossibile inserire il codice nei frame about:-frame di primo livello. Il valore predefinito è
false
. -
runAt
RunAt facoltativo
Non appena il codice JavaScript o CSS verrà inserito nella scheda. Il valore predefinito è "document_idle".
RunAt
Non appena il codice JavaScript o CSS verrà inserito nella scheda.
Enum
"document_start"
Lo script viene inserito dopo qualsiasi file da CSS, ma prima che venga creato qualsiasi altro DOM o venga eseguito qualsiasi altro script.
"document_end"
Lo script viene inserito subito dopo il completamento del DOM, ma prima che vengano caricate le risorse secondarie come immagini e frame.
"document_idle"
Il browser sceglie quando inserire lo script tra "document_end" e subito dopo l'attivazione dell'evento window.onload
. Il momento esatto dell'inserimento dipende dalla complessità del documento e dal tempo necessario per il caricamento ed è ottimizzato per la velocità di caricamento della pagina. Gli script di contenuti eseguiti su "document_idle" non devono rimanere in ascolto dell'evento window.onload
; la loro esecuzione è garantita al termine del DOM. Se uno script deve sicuramente essere eseguito dopo il giorno window.onload
, l'estensione può verificare se onload
è già stato attivato utilizzando la proprietà document.readyState
.