chrome.extensionTypes

Descrizione

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

Tipi

ColorArray

Chrome 139+

Tipo

[numero, numero, numero, numero]

CSSOrigin

Chrome 66+

L'origine del CSS inserito.

Enum

"author"

"user"

DeleteInjectionDetails

Chrome 87+

Dettagli del CSS da rimuovere. Devi impostare la proprietà del codice o del file, ma non entrambe 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 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+

Il ciclo di vita del documento del frame.

Enum

"prerender"

"active"

"memorizzato nella cache"

"pending_deletion"

ExecutionWorld

Chrome 111+

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 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+

Il tipo di frame.

Enum

"outermost_frame"

"fenced_frame"

"sub_frame"

ImageDataType

Chrome 139+

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

Tipo

ImageData

ImageDetails

Dettagli su formato, qualità e area 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+

Il formato di un'immagine.

Enum

"jpeg"

"png"

InjectDetails

Dettagli dello script o del CSS da inserire. Devi impostare la proprietà del codice o del file, ma non entrambe 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 principale. 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 inserire.

    Avviso: fai attenzione quando utilizzi il parametro code. L'utilizzo errato può esporre la tua estensione ad attacchi cross-site scripting.

  • cssOrigin

    CSSOrigin facoltativo

    Chrome 66+

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

  • file

    stringa facoltativa

    File JavaScript o CSS da inserire.

  • frameId

    number (facoltativo)

    Chrome 50 o 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ù vicino in cui JavaScript o CSS verrà inserito nella scheda. Il valore predefinito è "document_idle".

RunAt

Chrome 44+

Il momento più vicino in cui JavaScript o CSS verrà inserito nella scheda.

Enum

"document_start"
Lo script viene inserito dopo tutti i file CSS, ma prima che venga costruito 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 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 eseguiti in "document_idle" non devono rimanere in attesa dell'evento window.onload; è garantito che vengano eseguiti dopo il completamento 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.