chrome.topSites

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()

Versprechen 
chrome.topSites.get(
  callback?: function,
)

Ruft eine Liste der Top-Websites ab.

Parameters

Rückgaben

  • Promise<MostVisitedURL[]>

    Chrome 96 oder höher

    Promise-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.