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

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

"USER_SCRIPT"

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.