windows.update()

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.

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.

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

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);
});

• window-manipulator