windows.update()

Syntax

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 erregt, ohne das fokussierte Fenster zu ändern. Der Effekt hält an, bis der Benutzer den Fokus auf das Fenster ändert. Diese Option hat keine Wirkung, wenn das Fenster bereits im Fokus steht. Auf false setzen, um eine vorherige drawAttention-Anforderung abzubrechen.

focused Optional

boolean. Wenn true, wird das Fenster in den Vordergrund gebracht. Wenn false, wird das nächste Fenster in der Z-Ordnung 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 Versatz vom linken Bildschirmrand, 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 einen String am Anfang des Fenstertitels des Browsers hinzuzufügen. Abhängig vom darunterliegenden Betriebssystem funktioniert dies möglicherweise nicht bei Browserfenstern, die keinen Titel haben (z.B. about:blank in Firefox).

top Optional

integer. Der Versatz vom oberen Bildschirmrand, 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, welches die Details des aktualisierten Fensters enthält. Wenn ein Fehler auftritt, wird das Promise mit einer Fehlermeldung abgelehnt.

Beispiele

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

Beispielerweiterungen

• window-manipulator

Browser-Kompatibilität