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
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
. Wenntrue
, 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 auffalse
, um eine vorherigedrawAttention
-Anfrage abzubrechen. focused
Optional-
boolean
. Wenntrue
, wird das Fenster in den Vordergrund gebracht. Wennfalse
, 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ändeminimized
,maximized
undfullscreen
können nicht mitleft
,top
,width
oderheight
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:
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.