chrome.action

Descrizione

Utilizza l'API chrome.action per controllare l'icona dell'estensione nella barra degli strumenti di Google Chrome.

Le icone di azione vengono visualizzate nella barra degli strumenti del browser accanto all'omnibox. Dopo l'installazione, vengono visualizzate nel menu delle estensioni (l'icona a forma di pezzo di puzzle). Gli utenti possono bloccare l'icona dell'estensione nella barra degli strumenti.

Disponibilità

Chrome 88 e versioni successive MV3 e versioni successive

Manifest

Per utilizzare questa API, le seguenti chiavi devono essere dichiarate nel file manifest.

"action"

Per utilizzare l'API chrome.action, specifica un "manifest_version" di 3 e includi la chiave "action" nel file manifest.

Nota: ogni estensione ha un'icona nella barra degli strumenti di Chrome, anche se la chiave "action" non è aggiunta al file manifest.

{
  "name": "Action Extension",
  ...
  "action": {
    "default_icon": {              // optional
      "16": "images/icon16.png",   // optional
      "24": "images/icon24.png",   // optional
      "32": "images/icon32.png"    // optional
    },
    "default_title": "Click Me",   // optional, shown in tooltip
    "default_popup": "popup.html"  // optional
  },
  ...
}

La chiave "action" (insieme ai relativi elementi secondari) è facoltativa. Se non è inclusa, l'estensione viene comunque visualizzata nella barra degli strumenti per consentire l'accesso al relativo menu. Per questo motivo, ti consigliamo di includere sempre almeno le chiavi "action" e "default_icon".

Concetti e utilizzo

Parti dell'interfaccia utente

Icona

L'icona è l'immagine principale nella barra degli strumenti dell'estensione e viene impostata dalla chiave "default_icon" nella chiave "action" del manifest. Le icone devono avere una larghezza e un'altezza di 16 pixel indipendenti dal dispositivo (DIP).

La chiave "default_icon" è un dizionario di dimensioni per i percorsi delle immagini. Chrome utilizza queste icone per scegliere la scala dell'immagine da utilizzare. Se non viene trovata una corrispondenza esatta, Chrome seleziona la più simile disponibile e la ridimensiona in base all'immagine, il che potrebbe influire sulla qualità dell'immagine.

Poiché i dispositivi con fattori di scala meno comuni, come 1,5x o 1,2x, stanno diventando più comuni, ti invitiamo a fornire più dimensioni per le icone. In questo modo, la tua estensione sarà al sicuro da potenziali modifiche delle dimensioni di visualizzazione delle icone in futuro. Tuttavia, se fornisci una sola dimensione, la chiave "default_icon" può essere impostata anche su una stringa con il percorso di una singola icona anziché su un dizionario.

Puoi anche chiamare action.setIcon() per impostare l'icona dell'estensione in modo programmatico specificando un percorso immagine diverso o fornendo un'icona generata dinamicamente utilizzando l'elemento canvas HTML oppure, se l'impostazione viene eseguita da un worker di servizio dell'estensione, l'API canvas offscreen.

const canvas = new OffscreenCanvas(16, 16);
const context = canvas.getContext('2d');
context.clearRect(0, 0, 16, 16);
context.fillStyle = '#00FF00';  // Green
context.fillRect(0, 0, 16, 16);
const imageData = context.getImageData(0, 0, 16, 16);
chrome.action.setIcon({imageData: imageData}, () => { /* ... */ });

Nota: l'API action.setIcon() è progettata per impostare un'immagine statica. Non utilizzare immagini animate per le icone.

Per le estensioni pacchettizzate (installate da un file .crx), le immagini possono essere nella maggior parte dei formati che il motore di rendering Blink può visualizzare, inclusi PNG, JPEG, BMP, ICO e altri. SVG non è supportato. Le estensioni scompattate devono utilizzare immagini PNG.

Descrizione comando (titolo)

La descrizione comando o il titolo viene visualizzata quando l'utente passa il cursore del mouse sopra l'icona dell'estensione nella barra degli strumenti. Viene incluso anche nel testo accessibile pronunciato dagli screen reader quando il pulsante acquisisce il focus.

La descrizione comando predefinita viene impostata utilizzando il campo "default_title" della chiave "action" in manifest.json. Puoi anche impostarlo in modo programmatico chiamando action.setTitle().

Badge

Se vuoi, le azioni possono mostrare un "badge", ovvero un po' di testo sovrapposto all'icona. In questo modo puoi aggiornare l'azione in modo da visualizzare una piccola quantità di informazioni sullo stato dell'estensione, ad esempio un contatore. Il badge ha un componente di testo e un colore di sfondo. Poiché lo spazio è limitato, consigliamo di utilizzare al massimo quattro caratteri per il testo del badge.

Per creare un badge, impostalo in modo programmatico chiamando action.setBadgeBackgroundColor() e action.setBadgeText(). Nel file manifest non è presente un'impostazione predefinita per il badge. I valori di colore del badge possono essere un array di quattro numeri interi compresi tra 0 e 255 che compongono il colore RGBA del badge o una stringa con un valore colore CSS.

chrome.action.setBadgeBackgroundColor(
  {color: [0, 255, 0, 0]},  // Green
  () => { /* ... */ },
);

chrome.action.setBadgeBackgroundColor(
  {color: '#00FF00'},  // Also green
  () => { /* ... */ },
);

chrome.action.setBadgeBackgroundColor(
  {color: 'green'},  // Also, also green
  () => { /* ... */ },
);

Popup

Il popup di un'azione viene visualizzato quando l'utente fa clic sul pulsante di azione dell'estensione nella barra degli strumenti. Il popup può contenere qualsiasi contenuto HTML e verrà ridimensionato automaticamente in base ai contenuti. Le dimensioni del popup devono essere comprese tra 25 x 25 e 800 x 600 pixel.

Il popup viene impostato inizialmente dalla proprietà "default_popup" nella chiave "action" del manifest.json file. Se presente, questa proprietà deve puntare a un percorso relativo all'interno della directory dell'estensione. Può anche essere aggiornato dinamicamente in modo da puntare a un percorso relativo diverso utilizzando il metodo action.setPopup().

Nota: l'evento action.onClicked non verrà inviato se l'azione dell'estensione ha specificato un popup da mostrare al clic sulla scheda corrente.

Casi d'uso

Stato per scheda

Le azioni di estensione possono avere stati diversi per ogni scheda. Per impostare un valore per una singola scheda, utilizza la proprietà tabId nei metodi di impostazione dell'API action. Ad esempio, per impostare il testo del badge per una scheda specifica, procedi nel seguente modo:

function getTabId() { /* ... */}
function getTabBadge() { /* ... */}

chrome.action.setBadgeText(
  {
    text: getTabBadge(tabId),
    tabId: getTabId(),
  },
  () => { ... }
);

Se la proprietà tabId viene omessa, l'impostazione viene considerata globale. Le impostazioni specifiche della scheda hanno la priorità sulle impostazioni globali.

Stato attivo

Per impostazione predefinita, le azioni della barra degli strumenti sono abilitate (cliccabili) in ogni scheda. Puoi modificare questo valore predefinito impostando la proprietà default_state nella chiave action del manifest. Se default_state è impostato su "disabled", l'azione è disattivata per impostazione predefinita e deve essere attivata programmaticamente per essere cliccabile. Se default_state è impostato su "enabled" (il valore predefinito), l'azione è attiva e cliccabile per impostazione predefinita.

Puoi controllare lo stato in modo programmatico utilizzando i metodi action.enable() e action.disable(). Questo influisce solo sul fatto che l'eventuale popup o l'evento action.onClicked venga inviato alla tua estensione; non influisce sulla presenza dell'azione nella barra degli strumenti.

Esempi

Gli esempi seguenti mostrano alcuni modi comuni in cui le azioni vengono utilizzate nelle estensioni. Per provare questa API, installa l'esempio dell'API Action dal repository chrome-extension-samples.

Mostrare un popup

È normale che un'estensione mostri un popup quando l'utente fa clic sull'azione dell'estensione. Per implementare questa funzionalità nella tua estensione, dichiara il popup in manifest.json e specifica i contenuti che Chrome deve mostrare nel popup.

// manifest.json
{
  "name": "Action popup demo",
  "version": "1.0",
  "manifest_version": 3,
  "action": {
    "default_title": "Click to view a popup",
    "default_popup": "popup.html"
  }
}

<!-- popup.html -->
<!DOCTYPE html>
<html>
<head>
  <style>
    html {
      min-height: 5em;
      min-width: 10em;
      background: salmon;
    }
  </style>
</head>
<body>
  <p>Hello, world!</p>
</body>
</html>

Inserire uno script di contenuti al clic

Un pattern comune per le estensioni è esporre la funzionalità principale utilizzando l'azione dell'estensione. L'esempio seguente mostra questo pattern. Quando l'utente fa clic sull'azione, l'estensione inserisce uno script di contenuti nella pagina corrente. Lo script dei contenuti mostra quindi un avviso per verificare che tutto abbia funzionato come previsto.

// manifest.json
{
  "name": "Action script injection demo",
  "version": "1.0",
  "manifest_version": 3,
  "action": {
    "default_title": "Click to show an alert"
  },
  "permissions": ["activeTab", "scripting"],
  "background": {
    "service_worker": "background.js"
  }
}

// background.js
chrome.action.onClicked.addListener((tab) => {
  chrome.scripting.executeScript({
    target: {tabId: tab.id},
    files: ['content.js']
  });
});

// content.js
alert('Hello, world!');

Emulare azioni con declarativeContent

Questo esempio mostra come la logica di background di un'estensione può (a) disattivare un'azione per impostazione predefinita e (b) usare declarativeContent per attivarla su siti specifici.

// service-worker.js

// Wrap in an onInstalled callback to avoid unnecessary work
// every time the service worker is run
chrome.runtime.onInstalled.addListener(() => {
  // Page actions are disabled by default and enabled on select tabs
  chrome.action.disable();

  // Clear all rules to ensure only our expected rules are set
  chrome.declarativeContent.onPageChanged.removeRules(undefined, () => {
    // Declare a rule to enable the action on example.com pages
    let exampleRule = {
      conditions: [
        new chrome.declarativeContent.PageStateMatcher({
          pageUrl: {hostSuffix: '.example.com'},
        })
      ],
      actions: [new chrome.declarativeContent.ShowAction()],
    };

    // Finally, apply our new array of rules
    let rules = [exampleRule];
    chrome.declarativeContent.onPageChanged.addRules(rules);
  });
});

Tipi

OpenPopupOptions

Chrome 99 e versioni successive

Proprietà

• windowId

  number facoltativo

  L'ID della finestra in cui aprire il popup dell'azione. Se non specificato, il valore predefinito è la finestra attualmente attiva.

TabDetails

Proprietà

• tabId

  number facoltativo

  L'ID della scheda per cui eseguire la query sullo stato. Se non viene specificata alcuna scheda, viene restituito lo stato non specifico per la scheda.

UserSettings

Chrome 91 e versioni successive

La raccolta di impostazioni specificate dall'utente relative all'azione di un'estensione.

Proprietà

• isOnToolbar

  booleano

  Indica se l'icona di azione dell'estensione è visibile nella barra degli strumenti di primo livello delle finestre del browser (ovvero se l'estensione è stata "bloccata" dall'utente).

UserSettingsChange

Chrome 130 e versioni successive

Proprietà

• isOnToolbar

  booleano facoltativo

  Indica se l'icona di azione dell'estensione è visibile nella barra degli strumenti di primo livello delle finestre del browser (ovvero se l'estensione è stata "bloccata" dall'utente).

Metodi

disable()

Promessa

chrome.action.disable(
  tabId?: number,
  callback?: function,
)

Disattiva l'azione per una scheda.

Parametri

• tabId

  number facoltativo

  L'ID della scheda per la quale vuoi modificare l'azione.

• callback

  function facoltativa

  Il parametro callback ha il seguente aspetto:

  () => void

Resi

• Promise<void>

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

enable()

Promessa

chrome.action.enable(
  tabId?: number,
  callback?: function,
)

Attiva l'azione per una scheda. Per impostazione predefinita, le azioni sono attivate.

Parametri

• tabId

  number facoltativo

  L'ID della scheda per la quale vuoi modificare l'azione.

• callback

  function facoltativa

  Il parametro callback ha il seguente aspetto:

  () => void

Resi

• Promise<void>

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

getBadgeBackgroundColor()

Promessa

chrome.action.getBadgeBackgroundColor(
  details: TabDetails,
  callback?: function,
)

Restituisce il colore di sfondo dell'azione.

Parametri

• dettagli

  TabDetails

• callback

  function facoltativa

  Il parametro callback ha il seguente aspetto:

  (result: ColorArray) => void

  • risultato

    ColorArray

Resi

• Promise<browserAction.ColorArray>

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

getBadgeText()

Promessa

chrome.action.getBadgeText(
  details: TabDetails,
  callback?: function,
)

Recupera il testo del badge dell'azione. Se non viene specificata alcuna scheda, viene restituito il testo del badge non specifico per la scheda. Se displayActionCountAsBadgeText è attivato, verrà restituito un testo segnaposto, a meno che non sia presente l'autorizzazione declarativeNetRequestFeedback o non sia stato fornito un testo del badge specifico per la scheda.

Parametri

• dettagli

  TabDetails

• callback

  function facoltativa

  Il parametro callback ha il seguente aspetto:

  (result: string) => void

  • risultato

    stringa

Resi

• Promise<string>

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

getBadgeTextColor()

Promessa Chrome 110 e versioni successive

chrome.action.getBadgeTextColor(
  details: TabDetails,
  callback?: function,
)

Restituisce il colore del testo dell'azione.

Parametri

• dettagli

  TabDetails

• callback

  function facoltativa

  Il parametro callback ha il seguente aspetto:

  (result: ColorArray) => void

  • risultato

    ColorArray

Resi

• Promise<browserAction.ColorArray>

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

getPopup()

Promessa

chrome.action.getPopup(
  details: TabDetails,
  callback?: function,
)

Recupera il documento HTML impostato come popup per questa azione.

Parametri

• dettagli

  TabDetails

• callback

  function facoltativa

  Il parametro callback ha il seguente aspetto:

  (result: string) => void

  • risultato

    stringa

Resi

• Promise<string>

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

getTitle()

Promessa

chrome.action.getTitle(
  details: TabDetails,
  callback?: function,
)

Recupera il titolo dell'azione.

Parametri

• dettagli

  TabDetails

• callback

  function facoltativa

  Il parametro callback ha il seguente aspetto:

  (result: string) => void

  • risultato

    stringa

Resi

• Promise<string>

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

getUserSettings()

Promessa Chrome 91 e versioni successive

chrome.action.getUserSettings(
  callback?: function,
)

Restituisce le impostazioni specificate dall'utente relative all'azione di un'estensione.

Parametri

• callback

  function facoltativa

  Il parametro callback ha il seguente aspetto:

  (userSettings: UserSettings) => void

  • userSettings

    UserSettings

Resi

• Promise<UserSettings>

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

isEnabled()

Promessa Chrome 110 e versioni successive

chrome.action.isEnabled(
  tabId?: number,
  callback?: function,
)

Indica se l'azione dell'estensione è attivata per una scheda (o a livello globale se non viene fornito tabId). Le azioni abilitate utilizzando solo declarativeContent restituiscono sempre false.

Parametri

• tabId

  number facoltativo

  L'ID della scheda per la quale vuoi controllare lo stato di attivazione.

• callback

  function facoltativa

  Il parametro callback ha il seguente aspetto:

  (isEnabled: boolean) => void

  • isEnabled

    booleano

    True se l'azione dell'estensione è attiva.

Resi

• Promise<boolean>

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

openPopup()

Promessa Chrome 127 e versioni successive

chrome.action.openPopup(
  options?: OpenPopupOptions,
  callback?: function,
)

Si apre il popup dell'estensione. Tra Chrome 118 e Chrome 126, questa opzione è disponibile solo per le estensioni installate in base ai criteri.

Parametri

• opzioni

  OpenPopupOptions facoltativo

  Specifica le opzioni per l'apertura del popup.

• callback

  function facoltativa

  Il parametro callback ha il seguente aspetto:

  () => void

Resi

• Promise<void>

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

setBadgeBackgroundColor()

Promessa

chrome.action.setBadgeBackgroundColor(
  details: object,
  callback?: function,
)

Imposta il colore di sfondo del badge.

Parametri

• dettagli

  oggetto

  • colore

    stringa | ColorArray

    Un array di quattro numeri interi nell'intervallo [0,255] che compongono il colore RGBA del badge. Ad esempio, il rosso opaco è [255, 0, 0, 255]. Può anche essere una stringa con un valore CSS, con il rosso opaco #FF0000 o #F00.

  • tabId

    number facoltativo

    Limita la modifica al momento in cui è selezionata una determinata scheda. Viene reimpostato automaticamente quando la scheda viene chiusa.

• callback

  function facoltativa

  Il parametro callback ha il seguente aspetto:

  () => void

Resi

• Promise<void>

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

setBadgeText()

Promessa

chrome.action.setBadgeText(
  details: object,
  callback?: function,
)

Imposta il testo del badge per l'azione. Il badge viene visualizzato sopra l'icona.

Parametri

• dettagli

  oggetto

  • tabId

    number facoltativo

    Limita la modifica al momento in cui è selezionata una determinata scheda. Viene reimpostato automaticamente quando la scheda viene chiusa.

  • testo

    stringa facoltativa

    È possibile passare un numero qualsiasi di caratteri, ma nello spazio possono essere inseriti solo circa quattro caratteri. Se viene passata una stringa vuota (''), il testo del badge viene cancellato. Se tabId è specificato e text è null, il testo per la scheda specificata viene cancellato e viene utilizzato per impostazione predefinita il testo del badge globale.

• callback

  function facoltativa

  Il parametro callback ha il seguente aspetto:

  () => void

Resi

• Promise<void>

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

setBadgeTextColor()

Promessa Chrome 110 e versioni successive

chrome.action.setBadgeTextColor(
  details: object,
  callback?: function,
)

Imposta il colore del testo del badge.

Parametri

• dettagli

  oggetto

  • colore

    stringa | ColorArray

    Un array di quattro numeri interi nell'intervallo [0,255] che compongono il colore RGBA del badge. Ad esempio, il rosso opaco è [255, 0, 0, 255]. Può anche essere una stringa con un valore CSS, con il rosso opaco #FF0000 o #F00. Se non imposti questo valore, verrà scelto automaticamente un colore in contrasto con il colore di sfondo del badge in modo che il testo sia visibile. I colori con valori alfa equivalenti a 0 non verranno impostati e restituiranno un errore.

  • tabId

    number facoltativo

    Limita la modifica al momento in cui è selezionata una determinata scheda. Viene reimpostato automaticamente quando la scheda viene chiusa.

• callback

  function facoltativa

  Il parametro callback ha il seguente aspetto:

  () => void

Resi

• Promise<void>

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

setIcon()

Promessa

chrome.action.setIcon(
  details: object,
  callback?: function,
)

Imposta l'icona per l'azione. L'icona può essere specificata come percorso di un file immagine, come dati dei pixel di un elemento canvas o come dizionario di uno di questi. È necessario specificare la proprietà path o imageData.

Parametri

• dettagli

  oggetto

  • imageData

    ImageData | oggetto facoltativo

    Un oggetto ImageData o un dizionario {size -> ImageData} che rappresenta l'icona da impostare. Se l'icona è specificata come dizionario, l'immagine effettiva da utilizzare viene scelta in base alla densità dei pixel dello schermo. Se il numero di pixel dell'immagine che si adattano a un'unità di spazio sullo schermo è pari a scale, verrà selezionata l'immagine con dimensioni scale * n, dove n è la dimensione dell'icona nell'interfaccia utente. È necessario specificare almeno un'immagine. Tieni presente che "details.imageData = foo" è equivalente a "details.imageData = {'16': foo}"

  • percorso

    stringa | oggetto facoltativo

    Un percorso immagine relativo o un dizionario {size -> relative image path} che rimandi all'icona da impostare. Se l'icona è specificata come dizionario, l'immagine effettiva da utilizzare viene scelta in base alla densità dei pixel dello schermo. Se il numero di pixel dell'immagine che si adattano a un'unità di spazio sullo schermo è pari a scale, verrà selezionata l'immagine con dimensioni scale * n, dove n è la dimensione dell'icona nell'interfaccia utente. È necessario specificare almeno un'immagine. Tieni presente che "details.path = foo" è equivalente a "details.path = {'16': foo}"

  • tabId

    number facoltativo

    Limita la modifica al momento in cui è selezionata una determinata scheda. Viene reimpostato automaticamente quando la scheda viene chiusa.

• callback

  function facoltativa

  Il parametro callback ha il seguente aspetto:

  () => void

Resi

• Promise<void>

  Chrome 96 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 utilizzare entrambe nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo passato al callback.

setPopup()

Promessa

chrome.action.setPopup(
  details: object,
  callback?: function,
)

Imposta il documento HTML da aprire come popup quando l'utente fa clic sull'icona dell'azione.

Parametri

• dettagli

  oggetto

  • popup

    stringa

    Il percorso relativo al file HTML da mostrare in un popup. Se impostato sulla stringa vuota (''), non viene visualizzato alcun popup.

  • tabId

    number facoltativo

    Limita la modifica al momento in cui è selezionata una determinata scheda. Viene reimpostato automaticamente quando la scheda viene chiusa.

• callback

  function facoltativa

  Il parametro callback ha il seguente aspetto:

  () => void

Resi

• Promise<void>

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

setTitle()

Promessa

chrome.action.setTitle(
  details: object,
  callback?: function,
)

Imposta il titolo dell'azione. Viene visualizzato nella descrizione comando.

Parametri

• dettagli

  oggetto

  • tabId

    number facoltativo

    Limita la modifica al momento in cui è selezionata una determinata scheda. Viene reimpostato automaticamente quando la scheda viene chiusa.

  • titolo

    stringa

    La stringa che l'azione deve mostrare quando si passa il mouse sopra.

• callback

  function facoltativa

  Il parametro callback ha il seguente aspetto:

  () => void

Resi

• Promise<void>

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

Eventi

onClicked

chrome.action.onClicked.addListener(
  callback: function,
)

Viene attivato quando viene fatto clic su un'icona di azione. Questo evento non viene attivato se l'azione ha un popup.

Parametri

• callback

  funzione

  Il parametro callback ha il seguente aspetto:

  (tab: tabs.Tab) => void

  • tab

    tabs.Tab

onUserSettingsChanged

Chrome 130 e versioni successive

chrome.action.onUserSettingsChanged.addListener(
  callback: function,
)

Viene attivato quando le impostazioni specificate dall'utente relative all'azione di un'estensione cambiano.

Parametri

• callback

  funzione

  Il parametro callback ha il seguente aspetto:

  (change: UserSettingsChange) => void

  • modifica

    UserSettingsChange