chrome.extension

Descrizione

L'API chrome.extension include utilità che possono essere utilizzate da qualsiasi pagina dell'estensione. Include il supporto per lo scambio di messaggi tra un'estensione e i relativi script di contenuti o tra estensioni, come descritto in dettaglio in Passaggio di messaggi.

Tipi

ViewType

Chrome 44 e versioni successive

Il tipo di visualizzazione dell'estensione.

Enum

"tab"

"popup"

Proprietà

inIncognitoContext

Vero per gli script di contenuti eseguiti nelle schede di navigazione in incognito e per le pagine delle estensioni eseguite in un processo di navigazione in incognito. Quest'ultimo si applica solo alle estensioni con incognito_behavior "split".

Tipo

booleano

Metodi

getBackgroundPage()

Solo in primo piano 
chrome.extension.getBackgroundPage()

Restituisce l'oggetto "window" di JavaScript per la pagina in background in esecuzione all'interno dell'estensione corrente. Restituisce null se l'estensione non ha una pagina di sfondo.

Resi

  • Window | undefined

getViews()

Solo in primo piano 
chrome.extension.getViews(
  fetchProperties?: object,
)

Restituisce un array di oggetti "window" di JavaScript per ciascuna delle pagine in esecuzione all'interno dell'estensione corrente.

Parametri

  • fetchProperties

    Oggetto facoltativo

    • tabId

      number facoltativo

      Chrome 54 e versioni successive

      Trova una visualizzazione in base a un ID scheda. Se questo campo viene omesso, vengono restituite tutte le visualizzazioni.

    • tipo

      ViewType facoltativo

      Il tipo di visualizzazione da ottenere. Se omesso, restituisce tutte le visualizzazioni (incluse pagine e schede in background).

    • windowId

      number facoltativo

      La finestra a cui limitare la ricerca. Se omesso, restituisce tutte le visualizzazioni.

Resi

  • Window[]

    Array di oggetti globali

isAllowedFileSchemeAccess()

Promessa 
chrome.extension.isAllowedFileSchemeAccess(
  callback?: function,
)

Recupera lo stato dell'accesso dell'estensione allo schema "file://". Corrisponde all'impostazione "Consenti l'accesso agli URL dei file" per estensione controllata dall'utente, accessibile tramite la pagina chrome://extensions.

Parametri

  • callback

    function facoltativa

    Il parametro callback ha il seguente aspetto: 

    (isAllowedAccess: boolean) => void

    • isAllowedAccess

      booleano

      Vero se l'estensione può accedere allo schema "file://", falso in caso contrario.

Resi

  • Promise<boolean>

    Chrome 99 e versioni successive

    Le promesse sono supportate in Manifest V3 e versioni successive, ma i callback vengono forniti per la compatibilità con le versioni precedenti. Non puoi utilizzarli entrambi nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo passato al callback.

isAllowedIncognitoAccess()

Promessa 
chrome.extension.isAllowedIncognitoAccess(
  callback?: function,
)

Recupera lo stato dell'accesso dell'estensione alla modalità di navigazione in incognito. Corrisponde all'impostazione "Consentita in incognito" per estensione controllata dall'utente, accessibile tramite la pagina chrome://extensions.

Parametri

  • callback

    function facoltativa

    Il parametro callback ha il seguente aspetto: 

    (isAllowedAccess: boolean) => void

    • isAllowedAccess

      booleano

      Vero se l'estensione ha accesso alla modalità di navigazione in incognito, falso in caso contrario.

Resi

  • Promise<boolean>

    Chrome 99 e versioni successive

    Le promesse sono supportate in Manifest V3 e versioni successive, ma i callback vengono forniti per la compatibilità con le versioni precedenti. Non puoi utilizzarli entrambi nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo passato al callback.

setUpdateUrlData()

chrome.extension.setUpdateUrlData(
  data: string,
)

Imposta il valore del parametro CGI ap utilizzato nell'URL di aggiornamento dell'estensione. Questo valore viene ignorato per le estensioni ospitate nella Galleria di estensioni di Chrome.

Parametri

  • dati

    stringa

Eventi