Ta strona została przetłumaczona przez Cloud Translation API.

chrome.windows

Opis

Używaj interfejsu chrome.windows API do interakcji z oknami przeglądarki. Za pomocą tego interfejsu API możesz tworzyć, modyfikować i przenosić okna w przeglądarce.

Plik manifestu

Na żądanie obiekt windows.Window zawiera tablicę obiektów tabs.Tab. Jeśli potrzebujesz dostępu do właściwości url, pendingUrl, title lub favIconUrl obiektu tabs.Tab, musisz zadeklarować uprawnienie "tabs" w pliku manifestu. Na przykład:

{
  "name": "My extension",
  ...
  "permissions": ["tabs"],
  ...
}

bieżące okno,

Wiele funkcji w systemie rozszerzeń przyjmuje opcjonalny argument windowId, który domyślnie odnosi się do bieżącego okna.

Bieżące okno to okno zawierające kod, który jest obecnie wykonywany. Warto pamiętać, że może to być inne okno niż okno na wierzchu lub okno, na którym skupia się uwaga użytkownika.

Załóżmy na przykład, że rozszerzenie tworzy kilka kart lub okien z jednego pliku HTML, a plik HTML zawiera wywołanie tabs.query(). Bieżące okno to okno zawierające stronę, która wykonała wywołanie, niezależnie od tego, które okno jest najwyższe.

W przypadku service workerów wartość bieżącego okna wraca do ostatniego aktywnego okna. W niektórych przypadkach nie ma bieżącego okna dla stron działających w tle.

Przykłady

2 okna, każde z 1 kartą

Aby wypróbować ten interfejs API, zainstaluj przykład interfejsu API Windows z repozytorium chrome-extension-samples.

Typy

CreateType

Chrome 44 lub nowszy

Określa typ okna przeglądarki, które ma zostać utworzone. Typ „panel” jest wycofany i jest dostępny tylko w przypadku rozszerzeń umieszczonych na liście dozwolonych w systemie ChromeOS.

Typ wyliczeniowy

„normal”
Określa okno jako standardowe.

„popup”
Określa okno jako wyskakujące.

„panel”
Określa okno jako panel.

QueryOptions

Chrome 88 lub nowsza

Właściwości

wypełnić : uzupełnić

wartość logiczna opcjonalna

Jeśli wartość to „true”, obiekt windows.Window ma właściwość tabs, która zawiera listę obiektów tabs.Tab. Obiekty Tab zawierają właściwości url, pendingUrl, title i favIconUrl tylko wtedy, gdy plik manifestu rozszerzenia zawiera uprawnienie "tabs".
windowTypes

WindowType[] opcjonalny

Jeśli ten parametr jest ustawiony, zwracana wartość windows.Window jest filtrowana na podstawie jej typu. Jeśli nie jest ustawiony, domyślny filtr ma wartość ['normal', 'popup'].

Window

Właściwości

alwaysOnTop

Wartość logiczna

Określa, czy okno ma być zawsze na wierzchu.
skupiony,

Wartość logiczna

Określa, czy okno jest obecnie zaznaczone.
wysokość

number opcjonalny

Wysokość okna, łącznie z ramką, w pikselach. W niektórych przypadkach okno może nie mieć przypisanej właściwości height, np. podczas wysyłania zapytań o zamknięte okna z interfejsu sessions API.
id

number opcjonalny

Identyfikator okna. Identyfikatory okien są unikalne w ramach sesji przeglądarki. W niektórych przypadkach okno może nie mieć przypisanej właściwości ID, np. podczas wysyłania zapytań dotyczących okien za pomocą interfejsu sessions API. W takim przypadku może być obecny identyfikator sesji.
incognito

Wartość logiczna

Czy okno jest oknem incognito.
w lewo

number opcjonalny

Odsunięcie okna od lewej krawędzi ekranu w pikselach. W niektórych przypadkach okno może nie mieć przypisanej właściwości left, np. podczas wysyłania zapytań o zamknięte okna z interfejsu sessions API.
sessionId

string opcjonalny

Identyfikator sesji używany do jednoznacznej identyfikacji okna, uzyskany z interfejsu sessions API.
stan

WindowState opcjonalny

Stan tego okna przeglądarki.
karty,

Tab[] opcjonalny

Tablica obiektów tabs.Tab reprezentujących bieżące karty w oknie.
góra

number opcjonalny

Odsunięcie okna od górnej krawędzi ekranu w pikselach. W niektórych przypadkach okno może nie mieć przypisanej właściwości top, np. podczas wysyłania zapytań o zamknięte okna z interfejsu sessions API.
typ

WindowType opcjonalny

Typ okna przeglądarki.
szerokość

number opcjonalny

Szerokość okna (wraz z ramką) w pikselach. W niektórych przypadkach okno może nie mieć przypisanej właściwości width, np. podczas wysyłania zapytań o zamknięte okna z interfejsu sessions API.

WindowState

Chrome 44 lub nowszy

Stan tego okna przeglądarki. W niektórych przypadkach okno może nie mieć przypisanej właściwości state, np. podczas wysyłania zapytań o zamknięte okna z interfejsu sessions API.

Typ wyliczeniowy

„normal”
Normalny stan okna (niezminimalizowany, niezmaksymalizowany ani niepełnoekranowy).

„zminimalizowane”
Stan zminimalizowanego okna.

"maximized"
Zmaksymalizowany stan okna.

"fullscreen"
Stan okna w trybie pełnoekranowym.

„locked-fullscreen”
Stan okna w trybie pełnoekranowym zablokowanym. Użytkownik nie może wyjść z tego trybu pełnoekranowego. Jest on dostępny tylko dla rozszerzeń umieszczonych na liście dozwolonych w ChromeOS.

WindowType

Chrome 44 lub nowszy

Rodzaj okna przeglądarki. W niektórych przypadkach okno może nie mieć przypisanej właściwości type, np. podczas wysyłania zapytań o zamknięte okna z interfejsu sessions API.

Typ wyliczeniowy

„normal”
Zwykłe okno przeglądarki.

„popup”
Wyskakujące okienko przeglądarki.

„panel”
Wycofany w tym interfejsie API. Okno w stylu panelu aplikacji Chrome. Rozszerzenia widzą tylko własne okna panelu.

„app”
Wycofane w tym interfejsie API. okno aplikacji Chrome, Rozszerzenia mogą wyświetlać tylko własne okna aplikacji.

„devtools”
Okno Narzędzi dla programistów.

Właściwości

WINDOW_ID_CURRENT

Wartość windowId, która reprezentuje bieżące okno.

Wartość

-2

WINDOW_ID_NONE

Wartość windowId, która oznacza brak okna przeglądarki Chrome.

Wartość

-1

Metody

create()

Obietnica

chrome.windows.create(
  createData?: object,
  callback?: function,
): Promise<Window | undefined>

Tworzy (otwiera) nowe okno przeglądarki z opcjonalnym rozmiarem, położeniem lub domyślnym adresem URL.

Parametry

createData

obiekt opcjonalny
- skupiony,
  
  wartość logiczna opcjonalna
  
  Jeśli true, otwiera aktywne okno. Jeśli false, otwiera nieaktywne okno.
- wysokość
  
  number opcjonalny
  
  Wysokość nowego okna w pikselach, łącznie z ramką. Jeśli nie podasz tu żadnej wartości, zostanie użyta naturalna wysokość.
- incognito
  
  wartość logiczna opcjonalna
  
  Określa, czy nowe okno ma być oknem incognito.
- w lewo
  
  number opcjonalny
  
  Liczba pikseli, o którą nowe okno ma być odsunięte od lewej krawędzi ekranu. Jeśli nie określisz tego parametru, nowe okno zostanie przesunięte w naturalny sposób względem ostatniego okna, na którym skupiono uwagę. Ta wartość jest ignorowana w przypadku paneli.
- setSelfAsOpener
  
  wartość logiczna opcjonalna
  
  Chrome 64 lub nowsza
  
  Jeśli true, właściwość „window.opener” nowo utworzonego okna jest ustawiona na wywołującego i znajduje się w tej samej jednostce powiązanych kontekstów przeglądania co wywołujący.
- stan
  
  WindowState opcjonalny
  
  Chrome 44 lub nowszy
  
  Stan początkowy okna. Stanów minimized, maximized i fullscreen nie można łączyć ze stanami left, top, width ani height.
- tabId
  
  number opcjonalny
  
  Identyfikator karty, która ma zostać dodana do nowego okna.
- góra
  
  number opcjonalny
  
  Liczba pikseli, o którą nowe okno ma być odsunięte od górnej krawędzi ekranu. Jeśli nie określisz tego parametru, nowe okno zostanie przesunięte w naturalny sposób względem ostatniego okna, na którym skupiono uwagę. Ta wartość jest ignorowana w przypadku paneli.
- typ
  
  CreateType opcjonalny
  
  Określa typ okna przeglądarki, które ma zostać utworzone.
- URL
  
  string | string[] opcjonalny
  
  Adres URL lub tablica adresów URL do otwarcia jako karty w oknie. Pełne adresy URL muszą zawierać schemat, np. „http://www.google.com”, a nie „www.google.com”. Niepełne adresy URL są traktowane jako względne w ramach rozszerzenia. Domyślnie jest to strona Nowa karta.
- szerokość
  
  number opcjonalny
  
  Szerokość nowego okna w pikselach, łącznie z ramką. Jeśli nie podasz tu żadnej wartości, zostanie użyta naturalna szerokość.
callback

funkcja opcjonalna

Parametr callback wygląda tak:
```
(window?: Window) => void
```
- okno
  
  Window opcjonalny
  
  Zawiera szczegóły utworzonego okna.

Zwroty

Promise<Window | undefined>

Chrome 88 lub nowsza

Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą używać wywołań zwrotnych.

get()

Obietnica

chrome.windows.get(
  windowId: number,
  queryOptions?: QueryOptions,
  callback?: function,
): Promise<Window>

Pobiera szczegóły okna.

Parametry

windowId

liczba
queryOptions

QueryOptions opcjonalny

Chrome 88 lub nowsza
callback

funkcja opcjonalna

Parametr callback wygląda tak:
```
(window: Window) => void
```
- okno
  
  Okno

Zwroty

Promise<Window>

Chrome 88 lub nowsza

Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą używać wywołań zwrotnych.

getAll()

Obietnica

chrome.windows.getAll(
  queryOptions?: QueryOptions,
  callback?: function,
): Promise<Window[]>

Pobiera wszystkie okna.

Parametry

queryOptions

QueryOptions opcjonalny

Chrome 88 lub nowsza
callback

funkcja opcjonalna

Parametr callback wygląda tak:
```
(windows: Window[]) => void
```
- okna
  
  Window[]

Zwroty

Promise<Window[]>

Chrome 88 lub nowsza

Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą używać wywołań zwrotnych.

getCurrent()

Obietnica

chrome.windows.getCurrent(
  queryOptions?: QueryOptions,
  callback?: function,
): Promise<Window>

Pobiera bieżące okno.

Parametry

queryOptions

QueryOptions opcjonalny

Chrome 88 lub nowsza
callback

funkcja opcjonalna

Parametr callback wygląda tak:
```
(window: Window) => void
```
- okno
  
  Okno

Zwroty

Promise<Window>

Chrome 88 lub nowsza

Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą używać wywołań zwrotnych.

getLastFocused()

Obietnica

chrome.windows.getLastFocused(
  queryOptions?: QueryOptions,
  callback?: function,
): Promise<Window>

Pobiera okno, które było ostatnio aktywne – zwykle jest to okno „na wierzchu”.

Parametry

queryOptions

QueryOptions opcjonalny

Chrome 88 lub nowsza
callback

funkcja opcjonalna

Parametr callback wygląda tak:
```
(window: Window) => void
```
- okno
  
  Okno

Zwroty

Promise<Window>

Chrome 88 lub nowsza

Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą używać wywołań zwrotnych.

remove()

Obietnica

chrome.windows.remove(
  windowId: number,
  callback?: function,
): Promise<void>

Usuwa (zamyka) okno i wszystkie karty w nim otwarte.

Parametry

windowId

liczba
callback

funkcja opcjonalna

Parametr callback wygląda tak:
```
() => void
```

Zwroty

Promise<void>

Chrome 88 lub nowsza

Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą używać wywołań zwrotnych.

update()

Obietnica

chrome.windows.update(
  windowId: number,
  updateInfo: object,
  callback?: function,
): Promise<Window>

Aktualizuje właściwości okna. Określ tylko właściwości, które mają zostać zmienione. Właściwości nieokreślone pozostaną bez zmian.

Parametry

windowId

liczba
updateInfo

obiekt
- drawAttention
  
  wartość logiczna opcjonalna
  
  Jeśli true, powoduje wyświetlenie okna w sposób, który przyciąga uwagę użytkownika, bez zmiany okna, na którym jest skupiona uwaga. Efekt będzie trwał, dopóki użytkownik nie przełączy się na okno. Ta opcja nie ma wpływu, jeśli okno jest już aktywne. Ustaw jako false, aby anulować poprzednią prośbę drawAttention.
- skupiony,
  
  wartość logiczna opcjonalna
  
  Jeśli true, okno zostanie przeniesione na pierwszy plan. Nie można łączyć z stanem „zminimalizowane”. Jeśli false, przenosi następne okno w kolejności z do przodu; nie można łączyć ze stanem „pełny ekran” ani „zmaksymalizowany”.
- wysokość
  
  number opcjonalny
  
  Wysokość, do której ma zostać zmieniony rozmiar okna (w pikselach). Ta wartość jest ignorowana w przypadku paneli.
- w lewo
  
  number opcjonalny
  
  Odsunięcie od lewej krawędzi ekranu, o które należy przesunąć okno (w pikselach). Ta wartość jest ignorowana w przypadku paneli.
- stan
  
  WindowState opcjonalny
  
  Nowy stan okna. Stanów „zminimalizowany”, „zmaksymalizowany” i „pełny ekran” nie można łączyć ze stanami „lewy”, „górny”, „szerokość” ani „wysokość”.
- góra
  
  number opcjonalny
  
  Odsunięcie od górnej krawędzi ekranu, o które okno ma zostać przesunięte (w pikselach). Ta wartość jest ignorowana w przypadku paneli.
- szerokość
  
  number opcjonalny
  
  Szerokość, do której ma zostać zmieniony rozmiar okna (w pikselach). Ta wartość jest ignorowana w przypadku paneli.
callback

funkcja opcjonalna

Parametr callback wygląda tak:
```
(window: Window) => void
```
- okno
  
  Okno

Zwroty

Promise<Window>

Chrome 88 lub nowsza

Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą używać wywołań zwrotnych.

Wydarzenia

onBoundsChanged

Chrome w wersji 86 lub nowszej

chrome.windows.onBoundsChanged.addListener(
  callback: function,
)

Wywoływane, gdy rozmiar okna został zmieniony. To zdarzenie jest wysyłane tylko wtedy, gdy nowe granice zostaną zatwierdzone, a nie w przypadku zmian w toku.

Parametry

callback

funkcja

Parametr callback wygląda tak:
```
(window: Window) => void
```
- okno
  
  Okno

onCreated

chrome.windows.onCreated.addListener(
  callback: function,
  filters?: object,
)

Uruchamiane, gdy tworzone jest okno.

Parametry

callback

funkcja

Chrome 46 lub nowsza

Parametr callback wygląda tak:
```
(window: Window) => void
```
- okno
  
  Okno
  
  Szczegóły utworzonego okna.
filtry

obiekt opcjonalny
- windowTypes
  
  WindowType[]
  
  Warunki, które musi spełniać tworzony typ okna. Domyślnie spełnia warunek ['normal', 'popup'].

onFocusChanged

chrome.windows.onFocusChanged.addListener(
  callback: function,
  filters?: object,
)

Wysyłane, gdy zmieni się aktualnie aktywne okno. Zwraca wartość chrome.windows.WINDOW_ID_NONE, jeśli wszystkie okna Chrome utraciły fokus. Uwaga: w przypadku niektórych menedżerów okien w systemie Linux znak WINDOW_ID_NONE jest zawsze wysyłany bezpośrednio przed przełączeniem się z jednego okna Chrome na inne.

Parametry

callback

funkcja

Chrome 46 lub nowsza

Parametr callback wygląda tak:
```
(windowId: number) => void
```
- windowId
  
  liczba
  
  Identyfikator nowo aktywowanego okna.
filtry

obiekt opcjonalny
- windowTypes
  
  WindowType[]
  
  Warunki, które musi spełniać typ okna, aby można było go usunąć. Domyślnie spełnia warunek ['normal', 'popup'].

onRemoved

chrome.windows.onRemoved.addListener(
  callback: function,
  filters?: object,
)

Uruchamiane po usunięciu (zamknięciu) okna.

Parametry

callback

funkcja

Chrome 46 lub nowsza

Parametr callback wygląda tak:
```
(windowId: number) => void
```
- windowId
  
  liczba
  
  Identyfikator usuniętego okna.
filtry

obiekt opcjonalny
- windowTypes
  
  WindowType[]
  
  Warunki, które musi spełniać typ okna, aby można było go usunąć. Domyślnie spełnia warunek ['normal', 'popup'].

chrome.windows Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

Opis

Plik manifestu

bieżące okno,

Przykłady

Typy

CreateType

Typ wyliczeniowy

QueryOptions

Właściwości

Window

Właściwości

WindowState

Typ wyliczeniowy

WindowType

Typ wyliczeniowy

Właściwości

WINDOW_ID_CURRENT

Wartość

WINDOW_ID_NONE

Wartość

Metody

create()

Parametry

Zwroty

get()

Parametry

Zwroty

getAll()

Parametry

Zwroty

getCurrent()

Parametry

Zwroty

getLastFocused()

Parametry

Zwroty

remove()

Parametry

Zwroty

update()

Parametry

Zwroty

Wydarzenia

onBoundsChanged

Parametry

onCreated

Parametry

onFocusChanged

Parametry

onRemoved

Parametry

chrome.windows