chrome.topSites

Beschreibung

Verwenden Sie die chrome.topSites API, um auf die Top-Websites zuzugreifen (d.h. die am häufigsten besuchten Websites), die auf der Seite „Neuer Tab“ angezeigt werden. Dazu gehören keine vom Nutzer angepassten Verknüpfungen.

Berechtigungen

topSites

Manifest

Sie müssen „topSites“ deklarieren im Manifest der Erweiterung, um diese API zu verwenden.

{
  "name": "My extension",
  ...
  "permissions": [
    "topSites",
  ],
  ...
}

Beispiele

Um diese API auszuprobieren, installieren Sie das topSites API-Beispiel aus chrome-extension-samples. zu erstellen.

Typen

MostVisitedURL

Ein Objekt, das eine am häufigsten besuchte URL einschließt, z. B. die Standardverknüpfungen auf der Seite „Neuer Tab“.

Attribute

  • Titel

    String

    Der Titel der Seite

  • URL

    String

    Die am häufigsten besuchte URL.

Methoden

get()

<ph type="x-smartling-placeholder"></ph> Versprechen
chrome.topSites.get(
  callback?: function,
)

Ruft eine Liste der Top-Websites ab.

Parameter

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

    (data: MostVisitedURL[]) => void

Gibt Folgendes zurück:

  • Promise&lt;MostVisitedURL[]&gt;

    Chrome 96 und höher

    Promise-Objekte werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.