Beschreibung
Verwenden Sie die chrome.topSites
API, um auf die wichtigsten Websites (d.h. am häufigsten besuchte Websites) zuzugreifen, die auf der Seite „Neuer Tab“ angezeigt werden. Dies gilt nicht für vom Nutzer angepasste Tastenkombinationen.
Berechtigungen
topSites
Sie müssen die Berechtigung „topSites“ im Manifest Ihrer Erweiterung deklarieren, um diese API verwenden zu können.
{
"name": "My extension",
...
"permissions": [
"topSites",
],
...
}
Beispiele
Wenn Sie diese API testen möchten, installieren Sie das Beispiel für die TopSites API aus dem Repository chrome-extension-sample.
Typen
MostVisitedURL
Ein Objekt, das eine meistbesuchte URL einschließt, z. B. die Standardverknüpfungen auf der „Neuer Tab“-Seite.
Attribute
-
Titel
String
Titel der Seite
-
url
String
Die am häufigsten besuchte URL.
Methoden
get()
chrome.topSites.get(
callback?: function,
)
Ruft eine Liste der Top-Websites ab.
Parameters
-
callback
Funktion optional
Der Parameter
callback
sieht so aus:(data: MostVisitedURL[]) => void
-
Daten
-
Rückgaben
-
Promise<MostVisitedURL[]>
Chrome 96 oder höherPromise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks werden jedoch aus Gründen der Abwärtskompatibilität bereitgestellt. Sie können nicht beide in einem Funktionsaufruf verwenden. Das Promise wird mit demselben Typ aufgelöst, der an den Callback übergeben wird.