Questa pagina è stata tradotta dall'API Cloud Translation.

Eseguire l'override delle pagine di Chrome

Le estensioni possono utilizzare pagine di override HTML per sostituire una pagina fornita normalmente da Google Chrome. Un'estensione può contenere una sostituzione per una qualsiasi delle seguenti pagine, ma ogni estensione può sostituire solo una pagina:

Bookmark Manager: La pagina che viene visualizzata quando l'utente sceglie la voce di menu Gestione Preferiti dal menu Chrome o, su Mac, la voce Gestione Preferiti dal menu Preferiti. Puoi accedere a questa pagina anche inserendo l'URL chrome://bookmarks.
Cronologia: La pagina che viene visualizzata quando l'utente sceglie la voce di menu Cronologia dal menu Chrome o, su Mac, la voce Mostra cronologia completa dal menu Cronologia. Puoi accedere a questa pagina anche inserendo l'URL chrome://history.
Nuova scheda: La pagina che viene visualizzata quando l'utente crea una nuova scheda o finestra. Puoi accedere a questa pagina anche inserendo l'URL chrome://newtab.

I seguenti screenshot mostrano la pagina Nuova scheda predefinita e una pagina Nuova scheda personalizzata.

Per provare questa funzionalità, consulta i nostri esempi di override.

Comportamento finestra di navigazione in incognito

Nelle finestre di navigazione in incognito, le estensioni non possono eseguire l'override delle pagine Nuova scheda. Altre pagine continuano a funzionare se la proprietà del manifest incognito è impostata su "spanning" (il valore predefinito). Per informazioni dettagliate su come gestire le finestre di navigazione in incognito, vedi Salvataggio di dati e modalità di navigazione in incognito.

Manifest

Utilizza il seguente codice per registrare una pagina di override nel manifest dell'estensione:

{
  "manifest_version": 3,
  "name": "My extension",
  ...

  "chrome_url_overrides" : {
    "PAGE_TO_OVERRIDE": "myPage.html"
  },
  ...
}

Per PAGE_TO_OVERRIDE, sostituisci una delle seguenti opzioni:

"bookmarks"
"history"
"newtab"

best practice

Crea pagine piccole e veloci.
Gli utenti si aspettano che le pagine del browser integrate si aprano all'istante. Evita di svolgere operazioni che potrebbero richiedere molto tempo. In particolare, evita di accedere alle risorse del database in modo sincrono. Quando effettui richieste di rete, preferisci fetch() rispetto a XMLHttpRequest().
Per evitare di confondere gli utenti, assegna un titolo alla pagina.
Senza titolo, per impostazione predefinita il titolo della pagina è l'URL. Specifica il titolo utilizzando il tag <title> nel file HTML.
Ricorda che le nuove schede posizionano prima lo stato attivo della tastiera sulla barra degli indirizzi.
Non affidarti all'impostazione predefinita dello stato attivo della tastiera su altre parti della pagina.
Personalizza la pagina Nuova scheda.
Evita di creare una pagina Nuova scheda che gli utenti potrebbero confondere con la pagina Nuova scheda predefinita di Chrome.

Esempi

Consulta gli esempi di override.