chrome.bladwijzers

Beschrijving

Gebruik de chrome.bookmarks API om bladwijzers te maken, ordenen en anderszins te manipuleren. Zie ook Pagina's overschrijven , waarmee u een aangepaste pagina Bladwijzerbeheer kunt maken.

Als u op de ster klikt, wordt een bladwijzer toegevoegd
Als u op de ster klikt, wordt een bladwijzer toegevoegd.

Machtigingen

bookmarks

U moet de machtiging 'bladwijzers' opgeven in het extensiemanifest om de bladwijzers-API te kunnen gebruiken. Bijvoorbeeld:

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

Concepten en gebruik

Objecten en eigenschappen

Bladwijzers zijn georganiseerd in een boom, waarbij elk knooppunt in de boom een ​​bladwijzer of een map is (ook wel een groep genoemd). Elk knooppunt in de boom wordt vertegenwoordigd door een bookmarks.BookmarkTreeNode -object.

BookmarkTreeNode eigenschappen worden gebruikt in de chrome.bookmarks API. Als u bijvoorbeeld bookmarks.create aanroept, geeft u het bovenliggende knooppunt ( parentId ) en eventueel de eigenschappen index , title en url van het knooppunt door. Zie bookmarks.BookmarkTreeNode voor informatie over de eigenschappen die een knooppunt kan hebben.

Voorbeelden

Met de volgende code wordt een map gemaakt met de titel 'Extensiebladwijzers'. Het eerste argument voor create() specificeert eigenschappen voor de nieuwe map. Het tweede argument definieert een functie die moet worden uitgevoerd nadat de map is gemaakt.

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

Met het volgende fragment wordt een bladwijzer gemaakt die verwijst naar de ontwikkelaarsdocumentatie voor extensies. Omdat er niets ergs zal gebeuren als het maken van de bladwijzer mislukt, neemt deze code niet de moeite om een ​​callback-functie te definiëren.

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

Om deze API te proberen, installeert u het Bookmarks API-voorbeeld uit de chrome-extension-samples- repository.

Soorten

BookmarkTreeNode

Een knooppunt (een bladwijzer of een map) in de bladwijzerboom. Onderliggende knooppunten worden geordend in hun bovenliggende map.

Eigenschappen

  • kinderen

    BookmarkTreeNode [] optioneel

    Een geordende lijst met kinderen van dit knooppunt.

  • datumToegevoegd

    nummer optioneel

    Toen dit knooppunt werd gemaakt, in milliseconden sinds het tijdperk ( new Date(dateAdded) ).

  • dateGroupGewijzigd

    nummer optioneel

    Wanneer de inhoud van deze map voor het laatst is gewijzigd, in milliseconden sinds het tijdperk.

  • datumLaatstGebruikt

    nummer optioneel

    Chroom 114+

    Wanneer dit knooppunt voor het laatst werd geopend, in milliseconden sinds het tijdperk. Niet ingesteld voor mappen.

  • Identiteitskaart

    snaar

    De unieke ID voor het knooppunt. ID's zijn uniek binnen het huidige profiel en blijven geldig, zelfs nadat de browser opnieuw is opgestart.

  • index

    nummer optioneel

    De op 0 gebaseerde positie van dit knooppunt binnen de bovenliggende map.

  • ouderId

    tekenreeks optioneel

    De id van de bovenliggende map. Weggelaten voor het hoofdknooppunt.

  • titel

    snaar

    De tekst die wordt weergegeven voor het knooppunt.

  • onveranderbaar

    "beheerd"
    optioneel

    Geeft de reden aan waarom dit knooppunt niet kan worden gewijzigd. De managed waarde geeft aan dat dit knooppunt is geconfigureerd door de systeembeheerder of door de beheerder van een bewaakte gebruiker. Weggelaten als het knooppunt kan worden gewijzigd door de gebruiker en de extensie (standaard).

  • URL

    tekenreeks optioneel

    De URL waarnaar wordt genavigeerd wanneer een gebruiker op de bladwijzer klikt. Weggelaten voor mappen.

BookmarkTreeNodeUnmodifiable

Chroom 44+

Geeft de reden aan waarom dit knooppunt niet kan worden gewijzigd. De managed waarde geeft aan dat dit knooppunt is geconfigureerd door de systeembeheerder. Weggelaten als het knooppunt kan worden gewijzigd door de gebruiker en de extensie (standaard).

Waarde

"beheerd"

CreateDetails

Object doorgegeven aan de create() functie.

Eigenschappen

  • index

    nummer optioneel

  • ouderId

    tekenreeks optioneel

    Standaard ingesteld op de map Overige bladwijzers.

  • titel

    tekenreeks optioneel

  • URL

    tekenreeks optioneel

Eigenschappen

MAX_SUSTAINED_WRITE_OPERATIONS_PER_MINUTE

Afgekeurd

Het schrijven van bladwijzers wordt niet langer beperkt door Chrome.

Waarde

1000000

MAX_WRITE_OPERATIONS_PER_HOUR

Afgekeurd

Het schrijven van bladwijzers wordt niet langer beperkt door Chrome.

Waarde

1000000

Methoden

create()

Belofte
chrome.bookmarks.create(
  bookmark: CreateDetails,
  callback?: function,
)

Creëert een bladwijzer of map onder de opgegeven parentId. Als de URL NULL is of ontbreekt, is het een map.

Parameters

Retouren

  • Chroom 90+

    Beloften worden ondersteund in Manifest V3 en hoger, maar er zijn callbacks beschikbaar voor achterwaartse compatibiliteit. U kunt niet beide gebruiken bij dezelfde functieaanroep. De belofte wordt opgelost met hetzelfde type dat wordt doorgegeven aan de callback.

get()

Belofte
chrome.bookmarks.get(
  idOrIdList: string | [string, ...string[]],
  callback?: function,
)

Haalt de opgegeven BookmarkTreeNode(s) op.

Parameters

  • idOrIdLijst

    tekenreeks | [tekenreeks, ...tekenreeks[]]

    Eén ID met tekenreekswaarde of een reeks ID's met tekenreekswaarde

  • terugbellen

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    (results: BookmarkTreeNode[]) => void

Retouren

  • Belofte< BookmarkTreeNode []>

    Chroom 90+

    Beloften worden ondersteund in Manifest V3 en hoger, maar er zijn callbacks beschikbaar voor achterwaartse compatibiliteit. U kunt niet beide gebruiken bij dezelfde functieaanroep. De belofte wordt opgelost met hetzelfde type dat wordt doorgegeven aan de callback.

getChildren()

Belofte
chrome.bookmarks.getChildren(
  id: string,
  callback?: function,
)

Haalt de onderliggende elementen van de opgegeven BookmarkTreeNode-id op.

Parameters

  • Identiteitskaart

    snaar

  • terugbellen

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    (results: BookmarkTreeNode[]) => void

Retouren

  • Belofte< BookmarkTreeNode []>

    Chroom 90+

    Beloften worden ondersteund in Manifest V3 en hoger, maar er zijn callbacks beschikbaar voor achterwaartse compatibiliteit. U kunt niet beide gebruiken bij dezelfde functieaanroep. De belofte wordt opgelost met hetzelfde type dat wordt doorgegeven aan de callback.

getRecent()

Belofte
chrome.bookmarks.getRecent(
  numberOfItems: number,
  callback?: function,
)

Haalt de recent toegevoegde bladwijzers op.

Parameters

  • aantalItems

    nummer

    Het maximale aantal te retourneren artikelen.

  • terugbellen

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    (results: BookmarkTreeNode[]) => void

Retouren

  • Belofte< BookmarkTreeNode []>

    Chroom 90+

    Beloften worden ondersteund in Manifest V3 en hoger, maar er zijn callbacks beschikbaar voor achterwaartse compatibiliteit. U kunt niet beide gebruiken bij dezelfde functieaanroep. De belofte wordt opgelost met hetzelfde type dat wordt doorgegeven aan de callback.

getSubTree()

Belofte
chrome.bookmarks.getSubTree(
  id: string,
  callback?: function,
)

Haalt een deel van de bladwijzerhiërarchie op, beginnend bij het opgegeven knooppunt.

Parameters

  • Identiteitskaart

    snaar

    De ID van de hoofdmap van de subboom die moet worden opgehaald.

  • terugbellen

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    (results: BookmarkTreeNode[]) => void

Retouren

  • Belofte< BookmarkTreeNode []>

    Chroom 90+

    Beloften worden ondersteund in Manifest V3 en hoger, maar er zijn callbacks beschikbaar voor achterwaartse compatibiliteit. U kunt niet beide gebruiken bij dezelfde functieaanroep. De belofte wordt opgelost met hetzelfde type dat wordt doorgegeven aan de callback.

getTree()

Belofte
chrome.bookmarks.getTree(
  callback?: function,
)

Haalt de volledige bladwijzerhiërarchie op.

Parameters

Retouren

  • Belofte< BookmarkTreeNode []>

    Chroom 90+

    Beloften worden ondersteund in Manifest V3 en hoger, maar er zijn callbacks beschikbaar voor achterwaartse compatibiliteit. U kunt niet beide gebruiken bij dezelfde functieaanroep. De belofte wordt opgelost met hetzelfde type dat wordt doorgegeven aan de callback.

move()

Belofte
chrome.bookmarks.move(
  id: string,
  destination: object,
  callback?: function,
)

Verplaatst de opgegeven BookmarkTreeNode naar de opgegeven locatie.

Parameters

  • Identiteitskaart

    snaar

  • bestemming

    voorwerp

    • index

      nummer optioneel

    • ouderId

      tekenreeks optioneel

  • terugbellen

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    (result: BookmarkTreeNode) => void

Retouren

  • Chroom 90+

    Beloften worden ondersteund in Manifest V3 en hoger, maar er zijn callbacks beschikbaar voor achterwaartse compatibiliteit. U kunt niet beide gebruiken bij dezelfde functieaanroep. De belofte wordt opgelost met hetzelfde type dat wordt doorgegeven aan de callback.

remove()

Belofte
chrome.bookmarks.remove(
  id: string,
  callback?: function,
)

Verwijdert een bladwijzer of een lege bladwijzermap.

Parameters

  • Identiteitskaart

    snaar

  • terugbellen

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    () => void

Retouren

  • Beloof <nietig>

    Chroom 90+

    Beloften worden ondersteund in Manifest V3 en hoger, maar er zijn callbacks beschikbaar voor achterwaartse compatibiliteit. U kunt niet beide gebruiken bij dezelfde functieaanroep. De belofte wordt opgelost met hetzelfde type dat wordt doorgegeven aan de callback.

removeTree()

Belofte
chrome.bookmarks.removeTree(
  id: string,
  callback?: function,
)

Verwijdert recursief een bladwijzermap.

Parameters

  • Identiteitskaart

    snaar

  • terugbellen

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    () => void

Retouren

  • Beloof <nietig>

    Chroom 90+

    Beloften worden ondersteund in Manifest V3 en hoger, maar er zijn callbacks beschikbaar voor achterwaartse compatibiliteit. U kunt niet beide gebruiken bij dezelfde functieaanroep. De belofte wordt opgelost met hetzelfde type dat wordt doorgegeven aan de callback.

Belofte
chrome.bookmarks.search(
  query: string | object,
  callback?: function,
)

Zoekt naar BookmarkTreeNodes die overeenkomen met de opgegeven zoekopdracht. Query's die bij een object zijn opgegeven, produceren BookmarkTreeNodes die overeenkomen met alle opgegeven eigenschappen.

Parameters

  • vraag

    tekenreeks | voorwerp

    Ofwel een reeks woorden en geciteerde zinnen die worden vergeleken met bladwijzer-URL's en titels, of een object. Als een object de eigenschappen query , url en title kan specificeren, zullen er bladwijzers worden geproduceerd die overeenkomen met alle gespecificeerde eigenschappen.

    • vraag

      tekenreeks optioneel

      Een reeks woorden en geciteerde zinnen die worden vergeleken met bladwijzer-URL's en titels.

    • titel

      tekenreeks optioneel

      De titel van de bladwijzer; komt woordelijk overeen.

    • URL

      tekenreeks optioneel

      De URL van de bladwijzer; komt woordelijk overeen. Houd er rekening mee dat mappen geen URL hebben.

  • terugbellen

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    (results: BookmarkTreeNode[]) => void

Retouren

  • Belofte< BookmarkTreeNode []>

    Chroom 90+

    Beloften worden ondersteund in Manifest V3 en hoger, maar er zijn callbacks beschikbaar voor achterwaartse compatibiliteit. U kunt niet beide gebruiken bij dezelfde functieaanroep. De belofte wordt opgelost met hetzelfde type dat wordt doorgegeven aan de callback.

update()

Belofte
chrome.bookmarks.update(
  id: string,
  changes: object,
  callback?: function,
)

Werkt de eigenschappen van een bladwijzer of map bij. Geef alleen de eigenschappen op die u wilt wijzigen; niet-gespecificeerde eigenschappen blijven ongewijzigd. Let op: Momenteel worden alleen 'title' en 'url' ondersteund.

Parameters

  • Identiteitskaart

    snaar

  • veranderingen

    voorwerp

    • titel

      tekenreeks optioneel

    • URL

      tekenreeks optioneel

  • terugbellen

    functie optioneel

    De callback parameter ziet er als volgt uit: 

    (result: BookmarkTreeNode) => void

Retouren

  • Chroom 90+

    Beloften worden ondersteund in Manifest V3 en hoger, maar er zijn callbacks beschikbaar voor achterwaartse compatibiliteit. U kunt niet beide gebruiken bij dezelfde functieaanroep. De belofte wordt opgelost met hetzelfde type dat wordt doorgegeven aan de callback.

Evenementen

onChanged

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

Wordt geactiveerd wanneer een bladwijzer of map verandert. Opmerking: momenteel activeren alleen titel- en URL-wijzigingen dit.

Parameters

  • terugbellen

    functie

    De callback parameter ziet er als volgt uit: 

    (id: string, changeInfo: object) => void

    • Identiteitskaart

      snaar

    • wijzigInfo

      voorwerp

      • titel

        snaar

      • URL

        tekenreeks optioneel

onChildrenReordered

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

Wordt geactiveerd wanneer de onderliggende mappen van een map hun volgorde hebben gewijzigd omdat de volgorde in de gebruikersinterface is gesorteerd. Dit wordt niet aangeroepen als resultaat van een move().

Parameters

  • terugbellen

    functie

    De callback parameter ziet er als volgt uit: 

    (id: string, reorderInfo: object) => void

    • Identiteitskaart

      snaar

    • opnieuw bestellenInfo

      voorwerp

      • kinderIds

        snaar[]

onCreated

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

Wordt geactiveerd wanneer een bladwijzer of map wordt gemaakt.

Parameters

  • terugbellen

    functie

    De callback parameter ziet er als volgt uit: 

    (id: string, bookmark: BookmarkTreeNode) => void

onImportBegan

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

Wordt geactiveerd wanneer een bladwijzerimportsessie wordt gestart. Dure waarnemers moeten onCreated-updates negeren totdat onImportEnded wordt geactiveerd. Waarnemers moeten andere meldingen nog steeds onmiddellijk afhandelen.

Parameters

  • terugbellen

    functie

    De callback parameter ziet er als volgt uit: 

    () => void

onImportEnded

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

Wordt geactiveerd wanneer een bladwijzerimportsessie wordt beëindigd.

Parameters

  • terugbellen

    functie

    De callback parameter ziet er als volgt uit: 

    () => void

onMoved

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

Wordt geactiveerd wanneer een bladwijzer of map naar een andere bovenliggende map wordt verplaatst.

Parameters

  • terugbellen

    functie

    De callback parameter ziet er als volgt uit: 

    (id: string, moveInfo: object) => void

    • Identiteitskaart

      snaar

    • verplaatsInfo

      voorwerp

      • index

        nummer

      • oudeIndex

        nummer

      • oudOuderId

        snaar

      • ouderId

        snaar

onRemoved

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

Wordt geactiveerd wanneer een bladwijzer of map wordt verwijderd. Wanneer een map recursief wordt verwijderd, wordt er één melding afgegeven voor de map en geen melding voor de inhoud ervan.

Parameters

  • terugbellen

    functie

    De callback parameter ziet er als volgt uit: 

    (id: string, removeInfo: object) => void

    • Identiteitskaart

      snaar

    • verwijderInfo

      voorwerp