chrome.extensionTypes

Descrizione

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

Tipi

CSSOrigin

Chrome 66 e versioni successive

L'origine del CSS inserito.

Enum

DeleteInjectionDetails

Chrome 87 e versioni successive

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 impostati true e frameId, 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

Chrome 106 e versioni successive

Il ciclo di vita del documento del frame.

Enum

FrameType

Chrome 106 e versioni successive

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

Chrome 44 e versioni successive

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 impostati true e frameId, 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 successive

    L'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 successive

    Il 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

Chrome 44 e versioni successive

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.