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

chrome.bookmarks

Opis

Użyj interfejsu chrome.bookmarks API, aby tworzyć, porządkować i w inny sposób manipulować zakładkami. Zobacz też strony zastępowania, których możesz użyć do utworzenia niestandardowej strony menedżera zakładek.

Uprawnienia

bookmarks

Kliknięcie gwiazdki dodaje zakładkę

Plik manifestu

Aby korzystać z interfejsu Bookmarks API, musisz zadeklarować uprawnienie „bookmarks” w pliku manifestu rozszerzenia. Na przykład:

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

Obiekty i właściwości

Zakładki są uporządkowane w drzewie, w którym każdy węzeł jest zakładką lub folderem (czasami nazywanym grupą). Każdy węzeł w drzewie jest reprezentowany przez obiekt bookmarks.BookmarkTreeNode.

Właściwości BookmarkTreeNode są używane w całym interfejsie chrome.bookmarks API. Na przykład, gdy wywołujesz funkcję bookmarks.create, przekazujesz element nadrzędny nowego węzła (parentId) oraz opcjonalnie właściwości index, title i url węzła. Więcej informacji o właściwościach węzła znajdziesz w sekcji bookmarks.BookmarkTreeNode.

Przykłady

Ten kod tworzy folder o nazwie „Zakładki rozszerzenia”. Pierwszy argument funkcji create() określa właściwości nowego folderu. Drugi argument określa funkcję, która ma zostać wykonana po utworzeniu folderu.

chrome.bookmarks.create(
  {'parentId': bookmarkBar.id, 'title': 'Extension bookmarks'},
  function(newFolder) {
    console.log("added folder: " + newFolder.title);
  },
);

Kolejny fragment kodu tworzy zakładkę wskazującą dokumentację dla deweloperów dotyczącą rozszerzeń. Ponieważ nic złego się nie stanie, jeśli utworzenie zakładki się nie powiedzie, ten kod nie definiuje funkcji zwrotnej.

chrome.bookmarks.create({
  'parentId': extensionsFolderId,
  'title': 'Extensions doc',
  'url': 'https://developer.chrome.com/docs/extensions',
});

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

Typy

BookmarkTreeNode

Węzeł (zakładka lub folder) w drzewie zakładek. Węzły podrzędne są uporządkowane w folderze nadrzędnym.

Właściwości

dzieci

BookmarkTreeNode[] opcjonalnie

Uporządkowana lista elementów podrzędnych tego węzła.
dateAdded

number opcjonalny

Czas utworzenia tego węzła w milisekundach od początku epoki (new Date(dateAdded)).
dateGroupModified

number opcjonalny

Czas ostatniej zmiany zawartości tego folderu w milisekundach od początku epoki.
dateLastUsed

number opcjonalny

Chrome 114 lub nowsza

Czas ostatniego otwarcia tego węzła w milisekundach od początku epoki. Nie można ustawić dla folderów.
folderType

FolderType opcjonalny

Chrome 134 lub nowsza

Jeśli jest obecny, jest to folder dodany przez przeglądarkę, którego użytkownik ani rozszerzenie nie mogą modyfikować. Węzły podrzędne można modyfikować, jeśli ten węzeł nie ma ustawionej właściwości unmodifiable. Pomijane, jeśli węzeł może być modyfikowany przez użytkownika i rozszerzenie (domyślnie).

Każdy typ folderu może mieć 0, 1 lub więcej węzłów. Folder może zostać dodany lub usunięty przez przeglądarkę, ale nie za pomocą interfejsu API rozszerzeń.
id

ciąg znaków

Unikalny identyfikator węzła. Identyfikatory są unikalne w ramach bieżącego profilu i pozostają ważne nawet po ponownym uruchomieniu przeglądarki.
indeks

number opcjonalny

Pozycja tego węzła w folderze nadrzędnym (liczona od zera).
parentId

string opcjonalny

id folderu nadrzędnego. Pomijany w przypadku węzła głównego.
synchronizuję

Wartość logiczna

Chrome 134 lub nowsza

Określa, czy ten węzeł jest synchronizowany z zdalnym miejscem na dane na koncie użytkownika przez przeglądarkę. Można go używać do rozróżniania wersji tego samego FolderType na koncie i tylko lokalnie. Wartość tej właściwości może się zmienić w przypadku istniejącego węzła, np. w wyniku działania użytkownika.

Uwaga: ta informacja wskazuje, czy węzeł jest zapisany u wbudowanego dostawcy kont w przeglądarce. Węzeł może być synchronizowany przez podmiot zewnętrzny, nawet jeśli ta wartość jest fałszywa.

W przypadku węzłów zarządzanych (węzłów, w których wartość unmodifiable jest ustawiona na true) ta właściwość będzie zawsze miała wartość false.
tytuł

ciąg znaków

Tekst wyświetlany w węźle.
nie można go modyfikować,

„managed”
opcjonalny

Wskazuje przyczynę, dla której tego węzła nie można modyfikować. Wartość managed oznacza, że ten węzeł został skonfigurowany przez administratora systemu lub opiekuna nadzorowanego użytkownika. Pomijane, jeśli węzeł może być modyfikowany przez użytkownika i rozszerzenie (domyślnie).
URL

string opcjonalny

Adres URL, do którego użytkownik zostanie przekierowany po kliknięciu zakładki. Pomijane w przypadku folderów.

BookmarkTreeNodeUnmodifiable

Chrome 44 lub nowszy

Wskazuje przyczynę, dla której tego węzła nie można modyfikować. Wartość managed oznacza, że ten węzeł został skonfigurowany przez administratora systemu. Pomijane, jeśli węzeł może być modyfikowany przez użytkownika i rozszerzenie (domyślnie).

Wartość

„managed”

CreateDetails

Obiekt przekazany do funkcji create().

Właściwości

indeks

number opcjonalny
parentId

string opcjonalny

Domyślnie jest to folder Inne zakładki.
tytuł

string opcjonalny
URL

string opcjonalny

FolderType

Chrome 134 lub nowsza

Określa typ folderu.

Typ wyliczeniowy

„bookmarks-bar”
Folder, którego zawartość jest wyświetlana u góry okna przeglądarki.

„inne”
Zakładki wyświetlane na pełnej liście zakładek na wszystkich platformach.

„mobile”
Zakładki ogólnie dostępne na urządzeniach mobilnych użytkownika, ale modyfikowane przez rozszerzenie lub w menedżerze zakładek.

„zarządzane”
Folder najwyższego poziomu, który może być obecny, jeśli administrator systemu lub opiekun nadzorowanego użytkownika skonfigurował zakładki.

Właściwości

MAX_SUSTAINED_WRITE_OPERATIONS_PER_MINUTE

Wycofano

Operacje zapisu zakładek nie są już ograniczone przez Chrome.

Wartość

1000000

MAX_WRITE_OPERATIONS_PER_HOUR

Wycofano

Operacje zapisu zakładek nie są już ograniczone przez Chrome.

Wartość

1000000

Metody

create()

Obietnica

chrome.bookmarks.create(
  bookmark: CreateDetails,
  callback?: function,
): Promise<BookmarkTreeNode>

Tworzy zakładkę lub folder w ramach określonego elementu parentId. Jeśli adres URL ma wartość NULL lub nie występuje, będzie to folder.

Parametry

zakładka

CreateDetails
callback

funkcja opcjonalna

Parametr callback wygląda tak:
```
(result: BookmarkTreeNode) => void
```
- wynik
  
  BookmarkTreeNode

Zwroty

Promise<BookmarkTreeNode>

Chrome w wersji 90 lub nowszej

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

get()

Obietnica

chrome.bookmarks.get(
  idOrIdList: string | [string, ...string[]],
  callback?: function,
): Promise<BookmarkTreeNode[]>

Pobiera określone węzły BookmarkTreeNode.

Parametry

idOrIdList

string | [string, ...string[]]

Pojedynczy identyfikator w formie ciągu tekstowego lub tablica identyfikatorów w formie ciągów tekstowych.
callback

funkcja opcjonalna

Parametr callback wygląda tak:
```
(results: BookmarkTreeNode[]) => void
```
- wyniki
  
  BookmarkTreeNode[]

Zwroty

Promise<BookmarkTreeNode[]>

Chrome w wersji 90 lub nowszej

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

getChildren()

Obietnica

chrome.bookmarks.getChildren(
  id: string,
  callback?: function,
): Promise<BookmarkTreeNode[]>

Pobiera elementy podrzędne określonego węzła BookmarkTreeNode.

Parametry

id

ciąg znaków
callback

funkcja opcjonalna

Parametr callback wygląda tak:
```
(results: BookmarkTreeNode[]) => void
```
- wyniki
  
  BookmarkTreeNode[]

Zwroty

Promise<BookmarkTreeNode[]>

Chrome w wersji 90 lub nowszej

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

getRecent()

Obietnica

chrome.bookmarks.getRecent(
  numberOfItems: number,
  callback?: function,
): Promise<BookmarkTreeNode[]>

Pobiera ostatnio dodane zakładki.

Parametry

numberOfItems

liczba

Maksymalna liczba elementów do zwrócenia.
callback

funkcja opcjonalna

Parametr callback wygląda tak:
```
(results: BookmarkTreeNode[]) => void
```
- wyniki
  
  BookmarkTreeNode[]

Zwroty

Promise<BookmarkTreeNode[]>

Chrome w wersji 90 lub nowszej

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

getSubTree()

Obietnica

chrome.bookmarks.getSubTree(
  id: string,
  callback?: function,
): Promise<BookmarkTreeNode[]>

Pobiera część hierarchii zakładek, zaczynając od określonego węzła.

Parametry

id

ciąg znaków

Identyfikator korzenia poddrzewa do pobrania.
callback

funkcja opcjonalna

Parametr callback wygląda tak:
```
(results: BookmarkTreeNode[]) => void
```
- wyniki
  
  BookmarkTreeNode[]

Zwroty

Promise<BookmarkTreeNode[]>

Chrome w wersji 90 lub nowszej

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

getTree()

Obietnica

chrome.bookmarks.getTree(
  callback?: function,
): Promise<BookmarkTreeNode[]>

Pobiera całą hierarchię zakładek.

Parametry

callback

funkcja opcjonalna

Parametr callback wygląda tak:
```
(results: BookmarkTreeNode[]) => void
```
- wyniki
  
  BookmarkTreeNode[]

Zwroty

Promise<BookmarkTreeNode[]>

Chrome w wersji 90 lub nowszej

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

move()

Obietnica

chrome.bookmarks.move(
  id: string,
  destination: object,
  callback?: function,
): Promise<BookmarkTreeNode>

Przenosi określony węzeł BookmarkTreeNode do podanej lokalizacji.

Parametry

id

ciąg znaków
usługa docelowa | konto usługi docelowej

obiekt
- indeks
  
  number opcjonalny
- parentId
  
  string opcjonalny
callback

funkcja opcjonalna

Parametr callback wygląda tak:
```
(result: BookmarkTreeNode) => void
```
- wynik
  
  BookmarkTreeNode

Zwroty

Promise<BookmarkTreeNode>

Chrome w wersji 90 lub nowszej

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

remove()

Obietnica

chrome.bookmarks.remove(
  id: string,
  callback?: function,
): Promise<void>

Usuwa zakładkę lub pusty folder zakładek.

Parametry

id

ciąg znaków
callback

funkcja opcjonalna

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

Zwroty

Promise<void>

Chrome w wersji 90 lub nowszej

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

removeTree()

Obietnica

chrome.bookmarks.removeTree(
  id: string,
  callback?: function,
): Promise<void>

Rekursywnie usuwa folder zakładek.

Parametry

id

ciąg znaków
callback

funkcja opcjonalna

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

Zwroty

Promise<void>

Chrome w wersji 90 lub nowszej

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

search()

Obietnica

chrome.bookmarks.search(
  query: string | object,
  callback?: function,
): Promise<BookmarkTreeNode[]>

Wyszukuje węzły BookmarkTreeNode pasujące do podanego zapytania. Zapytania określone za pomocą obiektu zwracają węzły BookmarkTreeNodes pasujące do wszystkich określonych właściwości.

Parametry

zapytanie

string | object

Ciąg słów i wyrażeń w cudzysłowie, które są porównywane z adresami URL i tytułami zakładek, lub obiekt. Jeśli jest to obiekt, można określić właściwości query, url i title. Utworzone zostaną zakładki pasujące do wszystkich określonych właściwości.
- zapytanie
  
  string opcjonalny
  
  Ciąg słów i cytowanych wyrażeń, które są porównywane z adresami URL i tytułami zakładek.
- tytuł
  
  string opcjonalny
  
  Tytuł zakładki, który musi być identyczny.
- URL
  
  string opcjonalny
  
  Adres URL zakładki, który musi być identyczny. Pamiętaj, że foldery nie mają adresu URL.
callback

funkcja opcjonalna

Parametr callback wygląda tak:
```
(results: BookmarkTreeNode[]) => void
```
- wyniki
  
  BookmarkTreeNode[]

Zwroty

Promise<BookmarkTreeNode[]>

Chrome w wersji 90 lub nowszej

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

update()

Obietnica

chrome.bookmarks.update(
  id: string,
  changes: object,
  callback?: function,
): Promise<BookmarkTreeNode>

Aktualizuje właściwości zakładki lub folderu. Określ tylko właściwości, które chcesz zmienić. Właściwości, które nie zostaną określone, pozostaną bez zmian. Uwaga: obecnie obsługiwane są tylko parametry „title” i „url”.

Parametry

id

ciąg znaków
Zmiany

obiekt
- tytuł
  
  string opcjonalny
- URL
  
  string opcjonalny
callback

funkcja opcjonalna

Parametr callback wygląda tak:
```
(result: BookmarkTreeNode) => void
```
- wynik
  
  BookmarkTreeNode

Zwroty

Promise<BookmarkTreeNode>

Chrome w wersji 90 lub nowszej

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

Wydarzenia

onChanged

chrome.bookmarks.onChanged.addListener(
  callback: function,
)

Wysyłane, gdy zmieni się zakładka lub folder. Uwaga: obecnie tylko zmiany tytułu i adresu URL powodują to działanie.

Parametry

callback

funkcja

Parametr callback wygląda tak:
```
(id: string, changeInfo: object) => void
```
- id
  
  ciąg znaków
- changeInfo
  
  obiekt
  - tytuł
    
    ciąg znaków
  - URL
    
    string opcjonalny

onChildrenReordered

chrome.bookmarks.onChildrenReordered.addListener(
  callback: function,
)

Wywoływane, gdy kolejność elementów podrzędnych folderu ulegnie zmianie z powodu posortowania w interfejsie. Nie jest to wywoływane w wyniku wywołania funkcji move().

Parametry

callback

funkcja

Parametr callback wygląda tak:
```
(id: string, reorderInfo: object) => void
```
- id
  
  ciąg znaków
- reorderInfo
  
  obiekt
  - childIds
    
    string[]

onCreated

chrome.bookmarks.onCreated.addListener(
  callback: function,
)

Uruchamiane, gdy zostanie utworzona zakładka lub folder.

Parametry

callback

funkcja

Parametr callback wygląda tak:
```
(id: string, bookmark: BookmarkTreeNode) => void
```
- id
  
  ciąg znaków
- zakładka
  
  BookmarkTreeNode

onImportBegan

chrome.bookmarks.onImportBegan.addListener(
  callback: function,
)

Uruchamiane po rozpoczęciu sesji importowania zakładek. Obserwatorzy, którzy wymagają dużych nakładów obliczeniowych, powinni ignorować aktualizacje onCreated do momentu wywołania onImportEnded. Obserwatorzy powinni jednak natychmiast reagować na inne powiadomienia.

Parametry

callback

funkcja

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

onImportEnded

chrome.bookmarks.onImportEnded.addListener(
  callback: function,
)

Uruchamiane po zakończeniu sesji importowania zakładek.

Parametry

callback

funkcja

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

onMoved

chrome.bookmarks.onMoved.addListener(
  callback: function,
)

Wywoływane, gdy zakładka lub folder zostaną przeniesione do innego folderu nadrzędnego.

Parametry

callback

funkcja

Parametr callback wygląda tak:
```
(id: string, moveInfo: object) => void
```
- id
  
  ciąg znaków
- moveInfo
  
  obiekt
  - indeks
    
    liczba
  - oldIndex
    
    liczba
  - oldParentId
    
    ciąg znaków
  - parentId
    
    ciąg znaków

onRemoved

chrome.bookmarks.onRemoved.addListener(
  callback: function,
)

Wywoływane, gdy zakładka lub folder zostaną usunięte. Gdy folder jest usuwany rekursywnie, wysyłane jest jedno powiadomienie dotyczące folderu, a nie jego zawartości.

Parametry

callback

funkcja

Parametr callback wygląda tak:
```
(id: string, removeInfo: object) => void
```
- id
  
  ciąg znaków
- removeInfo
  
  obiekt
  - indeks
    
    liczba
  - węzeł
    
    BookmarkTreeNode
    
    Chrome 48 lub nowsza
  - parentId
    
    ciąg znaków

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

Opis

Uprawnienia

Plik manifestu

Obiekty i właściwości

Przykłady

Typy

BookmarkTreeNode

Właściwości

BookmarkTreeNodeUnmodifiable

Wartość

CreateDetails

Właściwości

FolderType

Typ wyliczeniowy

Właściwości

MAX_SUSTAINED_WRITE_OPERATIONS_PER_MINUTE

Wartość

MAX_WRITE_OPERATIONS_PER_HOUR

Wartość

Metody

create()

Parametry

Zwroty

get()

Parametry

Zwroty

getChildren()

Parametry

Zwroty

getRecent()

Parametry

Zwroty

getSubTree()

Parametry

Zwroty

getTree()

Parametry

Zwroty

move()

Parametry

Zwroty

remove()

Parametry

Zwroty

removeTree()

Parametry

Zwroty

search()

Parametry

Zwroty

update()

Parametry

Zwroty

Wydarzenia

onChanged

Parametry

onChildrenReordered

Parametry

onCreated

Parametry

onImportBegan

Parametry

onImportEnded

Parametry

onMoved

Parametry

onRemoved

Parametry

chrome.bookmarks