windows.update()

Aktualisiert die Eigenschaften eines Fensters. Verwenden Sie dies, um ein Fenster zu bewegen, die Größe zu ändern und den Fokus (ab)zuwenden usw.

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 hält an, bis der Benutzer den Fokus auf das Fenster ändert. Diese Option hat keine Wirkung, wenn das Fenster bereits den Fokus hat. Setzen Sie diesen Wert 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 angepasst werden soll. Dieser Wert wird für Panels ignoriert.

left Optional

integer. Der Versatz von der linken Bildschirmkante, auf den 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 eine Zeichenkette am Anfang des Titels des Browserfensters hinzuzufügen. Je nach zugrunde liegendem Betriebssystem funktioniert dies möglicherweise nicht bei Browserfenstern, die keinen Titel haben (wie z.B. about:blank in Firefox).

top Optional

integer. Der Versatz von der oberen Bildschirmkante, auf den 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 angepasst 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. Wenn ein Fehler auftritt, wird das Promise mit einer Fehlermeldung abgelehnt.

Browser-Kompatibilität

Beispiele

Wenn der Benutzer auf das Symbol einer Browseraktion klickt, soll das Fenster in die obere linke Ecke verschoben werden:

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

Beispielerweiterungen

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