cookies.get()

details

Ein object, das Details enthält, die verwendet werden können, um ein Cookie zum Abrufen zu identifizieren. Es kann die folgenden Eigenschaften enthalten:

firstPartyDomain Optional

Ein string, der die Erstanbieter-Domain darstellt, mit der das abzurufende Cookie verbunden ist. Diese Eigenschaft muss angegeben werden, wenn der Browser über "First-Party Isolation" verfügt. Siehe First-party isolation.

name

Ein string, der den Namen des abzurufenden Cookies darstellt.

partitionKey Optional

Ein object, das die Speicherpartition repräsentiert, die das Cookie enthält. Dieses Objekt mit topLevelSite enthalten, um ein Cookie aus partitioniertem Speicher abzurufen. Andernfalls wird das Cookie aus unpartitioniertem Speicher zurückgegeben. Dieses Objekt enthält:

topLevelSite Optional

Ein string, der die Erstanbieter-URL der Top-Level-Speicherpartition darstellt, die das Cookie enthält.

storeId Optional

Ein string, das die ID des Cookie Stores darstellt, in dem nach dem Cookie gesucht werden soll (wie von cookies.getAllCookieStores() zurückgegeben). Standardmäßig wird der Cookie Store des aktuellen Ausführungskontexts verwendet.

url

Ein string, der die URL darstellt, mit der das abzurufende Cookie verbunden ist. Dieses Argument kann eine vollständige URL sein, wobei alle Daten nach dem URL-Pfad ignoriert werden (z.B. die Abfragezeichenfolge). Wenn Host-Berechtigungen für diese URL nicht in der Manifest-Datei der Erweiterung angegeben sind, scheitert der API-Aufruf.

Ein Promise, das mit einem Cookie-Objekt erfüllt wird, das Details über das Cookie enthält, oder null, wenn das Cookie nicht gefunden wurde.

Dieses Beispiel versucht, das Cookie mit dem Namen "favorite-color" zu erhalten, das mit der URL des derzeit aktiven Tabs verbunden ist:

function logCookie(cookie) {
  if (cookie) {
    console.log(cookie.value);
  }
}

function getCookie(tabs) {
  let getting = browser.cookies.get({
    url: tabs[0].url,
    name: "favorite-color",
  });
  getting.then(logCookie);
}

let getActive = browser.tabs.query({
  active: true,
  currentWindow: true,
});
getActive.then(getCookie);

• cookie-bg-picker