chrome.extensionTypes

refresh date: 2026-09-25 robots: noindex

Descrizione

L'API chrome.extensionTypes contiene dichiarazioni di tipo per le estensioni di Chrome.

Tipi

ColorArray

Chrome 139 e versioni successive

Tipo

[number, number, number, number]

CSSOrigin

Chrome 66 e versioni successive

L'origine del CSS inserito.

Enum

"author"

"user"

DeleteInjectionDetails

Chrome 87 e versioni successive

Dettagli del CSS da rimuovere. È necessario impostare la proprietà code o file, ma non entrambe contemporaneamente.

Proprietà

  • allFrames

    boolean 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 true e frameId sono impostati, il codice viene rimosso dal frame selezionato e da tutti i relativi frame secondari.

  • codice

    stringa facoltativa

    Codice CSS da rimuovere.

  • cssOrigin

    CSSOrigin facoltativo

    L'origine del CSS da rimuovere. Il valore predefinito è "author".

  • file

    stringa facoltativa

    File CSS da rimuovere.

  • frameId

    number optional

    Il frame da cui deve essere rimosso il CSS. Il valore predefinito è 0 (il frame di primo livello).

  • matchAboutBlank

    boolean facoltativo

    Se matchAboutBlank è true, il codice viene rimosso anche dai frame about:blank e about:srcdoc se l'estensione ha accesso al documento principale. Il valore predefinito è false.

DocumentLifecycle

Chrome 106 e versioni successive

Il ciclo di vita del documento del frame.

Enum

"prerender"

"active"

"cached"

"pending_deletion"

ExecutionWorld

Chrome 111 e versioni successive

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

"ISOLATED"

"MAIN"

"USER_SCRIPT"

FrameType

Chrome 106 e versioni successive

Il tipo di frame.

Enum

"outermost_frame"

"fenced_frame"

"sub_frame"

ImageDataType

Chrome 139 e versioni successive

Dati dei pixel di un'immagine. Deve essere un oggetto ImageData, ad esempio di un elemento canvas.

Tipo

ImageData

ImageDetails

Dettagli sul formato, sulla qualità e sull'area di un'immagine.

Proprietà

  • formato

    ImageFormat facoltativo

    Il formato dell'immagine risultante. Il valore predefinito è "jpeg".

  • qualità

    number optional

    Quando 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

Chrome 44 e versioni successive

Il formato di un'immagine.

Enum

"jpeg"

"png"

InjectDetails

Dettagli dello script o del CSS da inserire. È necessario impostare la proprietà code o file, ma non entrambe contemporaneamente.

Proprietà

  • allFrames

    boolean 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 true e frameId sono impostati, il codice viene inserito nel frame selezionato e in tutti i relativi frame secondari.

  • codice

    stringa facoltativa

    Codice JavaScript o CSS da inserire.

    Avviso: fai attenzione quando utilizzi il parametro code. L'utilizzo errato potrebbe esporre l'estensione ad attacchi di cross-site scripting

  • cssOrigin

    CSSOrigin facoltativo

    Chrome 66 e versioni successive

    L'origine del CSS da inserire. Questo può essere specificato solo per CSS, non per JavaScript. Il valore predefinito è "author".

  • file

    stringa facoltativa

    File JavaScript o CSS da inserire.

  • frameId

    number optional

    Chrome 50+

    Il frame in cui deve essere inserito lo script o il CSS. Il valore predefinito è 0 (il frame di primo livello).

  • matchAboutBlank

    boolean facoltativo

    Se matchAboutBlank è impostato su true, il codice viene inserito anche nei frame about:blank e about:srcdoc se l'estensione ha accesso al documento principale. Impossibile inserire il codice in frame about: di primo livello. Il valore predefinito è false.

  • runAt

    RunAt facoltativo

    Il momento più prossimo in cui il codice JavaScript o CSS verrà inserito nella scheda. Il valore predefinito è "document_idle".

RunAt

Chrome 44 e versioni successive

Il momento più prossimo in cui il codice JavaScript o CSS verrà inserito nella scheda.

Enum

"document_start"
Lo script viene inserito dopo i file CSS, ma prima della creazione di qualsiasi altro DOM o dell'esecuzione di qualsiasi altro script.

"document_end"
Lo script viene inserito immediatamente dopo il completamento del DOM, ma prima del caricamento di risorse secondarie come immagini e frame.

"document_idle"
Il browser sceglie un momento per 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 dei contenuti in esecuzione in "document_idle" non devono rimanere in ascolto dell'evento window.onload; l'esecuzione dopo il completamento del DOM è garantita. Se uno script deve essere eseguito dopo window.onload, l'estensione può verificare se onload è già stato attivato utilizzando la proprietà document.readyState.