windows.update()

Aktualisiert die Eigenschaften eines Fensters. Verwenden Sie dies, um ein Fenster zu verschieben, die Größe zu ändern und ein Fenster (zu) fokussieren, etc.

Dies ist eine asynchrone Funktion, die ein Promise zurückgibt.

Syntax

js
let updating = browser.windows.update(
  windowId,              // integer
  updateInfo             // object
)

Parameter

windowId

integer. ID des Fensters, das aktualisiert werden soll.

updateInfo

object. Objekt, das die zu aktualisierenden Eigenschaften enthält.

drawAttention Optional

boolean. Wenn true, wird das Fenster so angezeigt, dass es die Aufmerksamkeit des Benutzers auf das Fenster lenkt, ohne das fokussierte Fenster zu ändern. Der Effekt dauert an, bis der Benutzer den Fokus auf das Fenster ändert. Diese Option hat keine Wirkung, wenn das Fenster bereits den Fokus hat. Setzen Sie auf false, um eine vorherige drawAttention-Anfrage abzubrechen.

focused Optional

boolean. Wenn true, wird das Fenster in den Vordergrund gebracht. Wenn false, wird das nächste Fenster in der Z-Reihenfolge in den Vordergrund gebracht.

height Optional

integer. Die Höhe, auf die das Fenster in Pixeln geändert werden soll. Dieser Wert wird für Panels ignoriert.

left Optional

integer. Der Abstand von der linken Kante des Bildschirms, zu dem das Fenster in Pixeln verschoben werden soll. Dieser Wert wird für Panels ignoriert.

state Optional

windows.WindowState. Der neue Zustand des Fensters. Die Zustände minimized, maximized und fullscreen können nicht mit left, top, width oder height kombiniert werden.

titlePreface Optional

string. Verwenden Sie dies, um dem Titel des Browserfensters eine Zeichenfolge voranzustellen. Abhängig vom zugrunde liegenden Betriebssystem funktioniert dies möglicherweise nicht bei Browserfenstern, die keinen Titel haben (wie zum Beispiel about:blank in Firefox).

top Optional

integer. Der Abstand von der oberen Kante des Bildschirms, zu dem das Fenster in Pixeln verschoben werden soll. Dieser Wert wird für Panels ignoriert.

width Optional

integer. Die Breite, auf die das Fenster in Pixeln geändert werden soll. Dieser Wert wird für Panels ignoriert.

Rückgabewert

Ein Promise, das mit einem windows.Window-Objekt erfüllt wird, das die Details des aktualisierten Fensters enthält. Bei einem Fehler wird das Promise mit einer Fehlermeldung abgelehnt.

Browser-Kompatibilität

BCD tables only load in the browser

Beispiele

Wenn der Benutzer auf das Symbol einer Browseraktion klickt, verschieben Sie das Fenster in die obere linke Ecke:

js
function onUpdated(windowInfo) {
  console.log(`Updated window: ${windowInfo.id}`);
}

function onError(error) {
  console.log(`Error: ${error}`);
}

browser.browserAction.onClicked.addListener((tab) => {
  let updating = browser.windows.update(tab.windowId, {
    left: 0,
    top: 0,
  });
  updating.then(onUpdated, onError);
});

Beispiel-Erweiterungen

Hinweis: Diese API basiert auf Chromiums chrome.windows API. Diese Dokumentation ist abgeleitet von windows.json im Chromium-Code.