Eseguire l'override delle pagine di Chrome

Le estensioni possono utilizzare pagine di override dell'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 una sola pagina:

Bookmark Manager

La pagina che viene visualizzata quando l'utente sceglie la voce di menu Gestione preferiti dal menu Chrome o, su Mac, dalla voce Gestione Preferiti del menu Preferiti. Puoi anche a questa pagina inserendo l'URL chrome://bookmarks.

Cronologia

La pagina che viene visualizzata quando l'utente sceglie la voce di menu Cronologia da Chrome oppure, su Mac, la voce Mostra cronologia completa dal menu Cronologia. Puoi anche visualizzare questa pagina inserendo l'URL chrome://history.

Nuova scheda

La pagina che viene visualizzata quando l'utente crea una nuova scheda o finestra. Puoi anche inserendo l'URL chrome://newtab.

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

Per provare questa opzione, consulta i nostri esempi di override.

Comportamento finestra di navigazione in incognito

Nelle finestre di navigazione in incognito, le estensioni non possono sostituire le pagine Nuova scheda. Le altre pagine continuano a funzionare se la proprietà del file manifest incognito è imposta su "spanning" (il valore predefinito). Per maggiori dettagli sulla gestione delle 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

• Rendi la tua pagina veloce e di dimensioni ridotte.
  Gli utenti si aspettano che le pagine del browser integrate si aprano all'istante. Evita di svolgere operazioni che potrebbero richiedere molto tempo nel tempo. In particolare, evita di accedere alle risorse di database in modo sincrono. Quando effettui richieste di rete, preferisci fetch() rispetto a XMLHttpRequest().

• Per evitare confusione per gli utenti, assegna un titolo alla pagina.
  Senza un titolo, il titolo della pagina corrisponde per impostazione predefinita all'URL. Specifica il titolo utilizzando il tag <title> nel file HTML.

• Ricorda che le nuove schede spostano prima lo stato attivo della tastiera sulla barra degli indirizzi.
  Non fare affidamento sull'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.