chrome.bladwijzers (original) (raw)
Manifest V3
chrome.bladwijzers
Beschrijving
Gebruik de chrome.bookmarks API om bladwijzers te maken, te ordenen en anderszins te bewerken. Zie ook 'Override Pages' , waarmee u een aangepaste Bookmark Manager-pagina kunt maken.
Als u op de ster klikt, wordt er een bladwijzer toegevoegd.
Machtigingen
bookmarks
U moet de machtiging 'bladwijzers' in het extensiemanifest declareren om de bladwijzers-API te gebruiken. Bijvoorbeeld:
{
"name": "My extension",
...
"permissions": [
"bookmarks"
],
...
}
Begrippen en gebruik
Objecten en eigenschappen
Bladwijzers zijn georganiseerd in een boomstructuur, waarbij elk knooppunt in de boomstructuur een bladwijzer of een map (soms een groep genoemd) is. Elk knooppunt in de boomstructuur wordt vertegenwoordigd door een bookmarks.BookmarkTreeNode -object.
BookmarkTreeNode eigenschappen worden gebruikt in de chrome.bookmarks API. Wanneer u bijvoorbeeld bookmarks.create aanroept, geeft u de bovenliggende node ( parentId ) en optioneel de index , title en url eigenschappen van de node door. Zie bookmarks.BookmarkTreeNode voor informatie over de eigenschappen die een node kan hebben.
Voorbeelden
De volgende code maakt een map aan met de titel "Extension bookmarks". Het eerste argument van create() specificeert eigenschappen voor de nieuwe map. Het tweede argument definieert een functie die moet worden uitgevoerd nadat de map is aangemaakt.
chrome.bookmarks.create(
{'parentId': bookmarkBar.id, 'title': 'Extension bookmarks'},
function(newFolder) {
console.log("added folder: " + newFolder.title);
},
);
Het volgende fragment creëert een bladwijzer die verwijst naar de ontwikkelaarsdocumentatie voor extensies. Omdat er niets misgaat als het aanmaken van de bladwijzer mislukt, neemt deze code niet de moeite om een callbackfunctie te definiëren.
chrome.bookmarks.create({
'parentId': extensionsFolderId,
'title': 'Extensions doc',
'url': 'https://developer.chrome.com/docs/extensions',
});
Om deze API uit te proberen, installeert u het Bookmarks API-voorbeeld uit de chrome-extension-samples repository.
Typen
BookmarkTreeNode
Een knooppunt (een bladwijzer of een map) in de bladwijzerboom. Onderliggende knooppunten worden geordend binnen hun bovenliggende map.
Eigenschappen
- kinderen
BookmarkTreeNode [] optioneel
Een geordende lijst van kinderen van dit knooppunt. - datum toegevoegd
nummer optioneel
Wanneer dit knooppunt is gemaakt, in milliseconden sinds het tijdperk (new Date(dateAdded)). - datumGroepGewijzigd
nummer optioneel
Wanneer de inhoud van deze map voor het laatst is gewijzigd, in milliseconden sinds het tijdperk. - datumLaatstGebruikt
nummer optioneel
Wanneer dit knooppunt voor het laatst is geopend, in milliseconden sinds het tijdperk. Niet ingesteld voor mappen. - mapType
FolderType optioneel
Indien aanwezig, is dit een map die door de browser wordt toegevoegd en die niet kan worden gewijzigd door de gebruiker of de extensie. Onderliggende knooppunten kunnen worden gewijzigd als dit knooppunt niet de eigenschapunmodifiableheeft. Weggelaten als het knooppunt door de gebruiker en de extensie kan worden gewijzigd (standaard).
Er kunnen nul, één of meerdere knooppunten van elk maptype zijn. Een map kan door de browser worden toegevoegd of verwijderd, maar niet via de extensie-API. - De unieke identificatiecode voor het knooppunt. ID's zijn uniek binnen het huidige profiel en blijven geldig, zelfs nadat de browser opnieuw is opgestart.
- De 0-gebaseerde positie van dit knooppunt binnen de bovenliggende map.
- ouder-ID
string optioneel
Deidvan de bovenliggende map. Weggelaten voor het hoofdknooppunt. - synchroniseren
Booleaanse
Of dit knooppunt door de browser wordt gesynchroniseerd met de externe accountopslag van de gebruiker. Dit kan worden gebruikt om onderscheid te maken tussen accountversies en lokale versies van hetzelfde FolderType . De waarde van deze eigenschap kan voor een bestaand knooppunt veranderen, bijvoorbeeld als gevolg van een gebruikersactie.
Let op: dit geeft aan of het knooppunt is opgeslagen in de ingebouwde accountprovider van de browser. Het is mogelijk dat een knooppunt via een derde partij wordt gesynchroniseerd, zelfs als deze waarde false is.
Voor beheerde knooppunten (knooppunten waarbijunmodifiableis ingesteld optrue), zal deze eigenschap altijdfalsezijn. - De tekst die voor het knooppunt wordt weergegeven.
- onveranderlijk
"beheerd"
optioneel
Geeft de reden aan waarom dit knooppunt niet kan worden gewijzigd. Demanagedwaarde geeft aan dat dit knooppunt is geconfigureerd door de systeembeheerder of door de beheerder van een gesuperviseerde gebruiker. Wordt weggelaten als het knooppunt kan worden gewijzigd door de gebruiker en de extensie (standaard). - De URL waarheen genavigeerd wordt wanneer een gebruiker op de bladwijzer klikt. Weggelaten voor mappen.
BookmarkTreeNodeUnmodifiable
Geeft de reden aan waarom dit knooppunt niet kan worden gewijzigd. De managed waarde geeft aan dat dit knooppunt is geconfigureerd door de systeembeheerder. Wordt weggelaten als het knooppunt kan worden gewijzigd door de gebruiker en de extensie (standaard).
CreateDetails
Object doorgegeven aan de create()-functie.
Eigenschappen
- ouder-ID
string optioneel
Standaard staat deze map in de map Overige bladwijzers.
FolderType
Geeft het type map aan.
Enum
"bladwijzerbalk"
De map waarvan de inhoud bovenaan het browservenster wordt weergegeven.
"ander"
Bladwijzers die worden weergegeven in de volledige lijst met bladwijzers op alle platforms.
"mobiel"
Bladwijzers zijn doorgaans beschikbaar op de mobiele apparaten van de gebruiker, maar kunnen worden gewijzigd via een extensie of in de bladwijzerbeheerder.
"beheerd"
Een map op het hoogste niveau die aanwezig kan zijn als de systeembeheerder of de beheerder van een bewaakte gebruiker bladwijzers heeft geconfigureerd.
Eigenschappen
MAX_SUSTAINED_WRITE_OPERATIONS_PER_MINUTE
De schrijfbewerkingen voor bladwijzers worden niet langer beperkt door Chrome.
MAX_WRITE_OPERATIONS_PER_HOUR
De schrijfbewerkingen voor bladwijzers worden niet langer beperkt door Chrome.
Methoden
create()
chrome.bookmarks.create(
bookmark: CreateDetails,
): Promise<BookmarkTreeNode>
Maakt een bladwijzer of map aan onder de opgegeven parent-ID. Als url NULL is of ontbreekt, wordt het een map.
Parameters
Retourneren
- Belofte< BookmarkTreeNode >
get()
chrome.bookmarks.get(
idOrIdList: string | [string, ...string[]],
): Promise<BookmarkTreeNode[]>
Haalt de opgegeven BookmarkTreeNode(s) op.
Parameters
- idOfIdLijst
tekenreeks | [tekenreeks, ...tekenreeks[]]
Een enkele tekenreeks-id, of een reeks tekenreeks-id's
Retourneren
- Belofte< BookmarkTreeNode []>
getChildren()
chrome.bookmarks.getChildren(
id: string,
): Promise<BookmarkTreeNode[]>
Haalt de onderliggende items op van de opgegeven BookmarkTreeNode-id.
Parameters
Retourneren
- Belofte< BookmarkTreeNode []>
getRecent()
chrome.bookmarks.getRecent(
numberOfItems: number,
): Promise<BookmarkTreeNode[]>
Haalt de recent toegevoegde bladwijzers op.
Parameters
- Het maximale aantal te retourneren artikelen.
Retourneren
- Belofte< BookmarkTreeNode []>
getSubTree()
chrome.bookmarks.getSubTree(
id: string,
): Promise<BookmarkTreeNode[]>
Haalt een deel van de bladwijzerhiërarchie op, beginnend bij het opgegeven knooppunt.
Parameters
- De ID van de root van de subboom die moet worden opgehaald.
Retourneren
- Belofte< BookmarkTreeNode []>
getTree()
chrome.bookmarks.getTree(): Promise<BookmarkTreeNode[]>
Haalt de volledige bladwijzerhiërarchie op.
Retourneren
- Belofte< BookmarkTreeNode []>
move()
chrome.bookmarks.move(
id: string,
destination: object,
): Promise<BookmarkTreeNode>
Verplaatst de opgegeven BookmarkTreeNode naar de opgegeven locatie.
Parameters
- ouder-ID
string optioneel
- ouder-ID
Retourneren
- Belofte< BookmarkTreeNode >
remove()
chrome.bookmarks.remove(
id: string,
): Promise
Verwijdert een bladwijzer of een lege bladwijzermap.
Parameters
Retourneren
removeTree()
chrome.bookmarks.removeTree(
id: string,
): Promise
Verwijdert recursief een bladwijzermap.
Parameters
Retourneren
search()
chrome.bookmarks.search(
query: string | object,
): Promise<BookmarkTreeNode[]>
Zoekt naar BookmarkTreeNodes die voldoen aan de opgegeven query. Query's die met een object zijn opgegeven, genereren BookmarkTreeNodes die voldoen aan alle opgegeven eigenschappen.
Parameters
- vraag
tekenreeks | object
Ofwel een reeks woorden en aanhalingstekens die worden vergeleken met bladwijzer-URL's en titels, ofwel een object. Bij een object kunnen de eigenschappenquery,urlentitleworden opgegeven. Bladwijzers die aan alle opgegeven eigenschappen voldoen, worden gegenereerd.- Een reeks woorden en tussen aanhalingstekens geplaatste zinnen die worden vergeleken met bladwijzer-URL's en titels.
- De titel van de bladwijzer komt letterlijk overeen.
- De URL van de bladwijzer komt letterlijk overeen. Merk op dat mappen geen URL hebben.
Retourneren
- Belofte< BookmarkTreeNode []>
update()
chrome.bookmarks.update(
id: string,
changes: object,
): Promise<BookmarkTreeNode>
Werkt de eigenschappen van een bladwijzer of map bij. Geef alleen de eigenschappen op die u wilt wijzigen; niet-gespecificeerde eigenschappen blijven ongewijzigd. Opmerking: Momenteel worden alleen 'titel' en 'url' ondersteund.
Parameters
Retourneren
- Belofte< BookmarkTreeNode >
Evenementen
onChanged
chrome.bookmarks.onChanged.addListener(
callback: function,
)
Wordt geactiveerd wanneer een bladwijzer of map verandert. Let op: momenteel worden deze acties alleen uitgevoerd bij wijzigingen in de titel en URL.
Parameters
- De
callbackziet er als volgt uit:
(id: string, changeInfo: object) => void
onChildrenReordered
chrome.bookmarks.onChildrenReordered.addListener(
callback: function,
)
Wordt geactiveerd wanneer de volgorde van de onderliggende mappen van een map is gewijzigd vanwege de sortering in de gebruikersinterface. Dit wordt niet aangeroepen als gevolg van een move().
Parameters
- De
callbackziet er als volgt uit:
(id: string, reorderInfo: object) => void- herbestellingsinfo
voorwerp
- herbestellingsinfo
onCreated
chrome.bookmarks.onCreated.addListener(
callback: function,
)
Wordt geactiveerd wanneer een bladwijzer of map wordt aangemaakt.
Parameters
- De
callbackziet 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 dienen onCreated-updates te negeren totdat onImportEnded wordt geactiveerd. Waarnemers dienen andere meldingen nog steeds direct te verwerken.
Parameters
- De
callbackziet er als volgt uit:
() => void
onImportEnded
chrome.bookmarks.onImportEnded.addListener(
callback: function,
)
Wordt geactiveerd wanneer een bladwijzerimportsessie wordt beëindigd.
Parameters
- De
callbackziet 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
- De
callbackziet er als volgt uit:
(id: string, moveInfo: object) => void
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 voor de map gegenereerd en geen enkele melding voor de inhoud ervan.
Parameters
- De
callbackziet er als volgt uit:
(id: string, removeInfo: object) => void
Tenzij anders vermeld, is de content op deze pagina gelicentieerd onder de Creative Commons Attribution 4.0-licentie en zijn codevoorbeelden gelicentieerd onder de Apache 2.0-licentie. Voor meer informatie raadpleegt u het Google Developers-sitebeleid. Java is een gedeponeerd handelsmerk van Oracle en/of diens aangesloten entiteiten.
Last updated 2025-08-11 UTC.