chrome.extensionTypes

Descrizione

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

Tipi

ColorArray

In attesa

Tipo

[numero, numero, numero, numero]

CSSOrigin

Chrome 66 e versioni successive

L'origine del CSS iniettato.

Enum

"author"

"user"

DeleteInjectionDetails

Chrome 87 e versioni successive

Dettagli del CSS da rimuovere. È necessario impostare il codice o la proprietà file, ma non entrambi contemporaneamente.

Proprietà

  • allFrames

    booleano facoltativo

    Se allFrames è true, implica che il CSS debba essere rimosso da tutti i frame della pagina corrente. Per impostazione predefinita, è false e viene rimosso solo dal frame superiore. Se sono impostati true e frameId, 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 facoltativo

    Il frame da cui deve essere rimosso il CSS. Il valore predefinito è 0 (il 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 documento principale. Il valore predefinito è false.

DocumentLifecycle

Chrome 106 e versioni successive

Il ciclo di vita del documento dell'inquadratura.

Enum

"prerender"

"active"

"cached"

"pending_deletion"

ExecutionWorld

Chrome 111 e versioni successive

L'ambiente JavaScript in cui deve essere eseguito uno script. Può essere un mondo isolato unico 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

In attesa

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

Tipo

ImageData

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à

    number facoltativo

    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 memorizzarla diminuirà.

ImageFormat

Chrome 44 e versioni successive

Il formato di un'immagine.

Enum

"jpeg"

"png"

InjectDetails

Dettagli dello script o del CSS da iniettare. È necessario impostare il codice o la proprietà file, ma non entrambi contemporaneamente.

Proprietà

  • allFrames

    booleano facoltativo

    Se allFrames è true, implica che il codice JavaScript o CSS debba essere inserito in tutti i frame della pagina corrente. Per impostazione predefinita, è false e viene inserito solo nel frame superiore. Se sono impostati true e frameId, il codice viene inserito nel frame selezionato e in tutti i relativi frame secondari.

  • codice

    stringa facoltativa

    Codice JavaScript o CSS da iniettare.

    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 iniettare. Questo può essere specificato solo per CSS, non per JavaScript. Il valore predefinito è "author".

  • file

    stringa facoltativa

    File JavaScript o CSS da iniettare.

  • frameId

    number facoltativo

    Chrome 50 e versioni successive

    Il frame in cui deve essere inserito lo script o il CSS. Il valore predefinito è 0 (il 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 documento principale. Il codice non può essere inserito nei frame about: di primo livello. Il valore predefinito è false.

  • runAt

    RunAt facoltativo

    Il momento più rapido 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ù rapido in cui il codice JavaScript o CSS verrà inserito nella scheda.

Enum

"document_start"
Lo script viene inserito dopo i file CSS, ma prima che venga creato qualsiasi altro DOM o eseguito qualsiasi altro script.

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

"document_idle"
Il browser sceglie un momento per iniettare lo script tra "document_end" e immediatamente dopo l'attivazione dell'evento window.onload. Il momento esatto dell'iniezione dipende dalla complessità del documento e dal tempo necessario per il caricamento ed è ottimizzato per la velocità di caricamento della pagina. Gli script di contenuto in esecuzione in "document_idle" non devono ascoltare l'evento window.onload; viene garantita la loro esecuzione al termine del DOM. Se uno script deve essere eseguito dopo window.onload, l'estensione può verificare se onload è già stato attivato utilizzando la proprietà document.readyState.