bookmarks
A API WebExtensions bookmarks permite uma extensão interagir e manipular o sistema de favoritos do navegador. Você pode pode usá-lo para favoritar páginas, obter favoritos existentes e, editar, remover ou organizar os favoritos.
Para utilizar esta API, uma extensão deve ser requisitada para o "bookmarks" permission em seu arquivo manifest.json .
Tipos
bookmarks.BookmarkTreeNode-
Representa um favorito ou um diretório de favoritos como árvore.
bookmarks.BookmarkTreeNodeType-
O enum
Stringo qual descreve se um nó na árvore é ou não um favorito, uma pasta ou um separador. bookmarks.BookmarkTreeNodeUnmodifiable-
O enum
Stringo qual especifica porque um favorito ou uma pasta não pode ser modificado. bookmarks.CreateDetails-
Contém informações ao qual é passada para a função
bookmarks.create()quando um novo favorito é criado.
Funções
bookmarks.create()-
Cria um favorito ou uma pasta.
bookmarks.get()-
Retrieves one or more
BookmarkTreeNodes, given a bookmark's ID or an array of bookmark IDs. bookmarks.getChildren()-
Recupera os filhos especificados
BookmarkTreeNode. bookmarks.getRecent()-
Recupera um número requisitado de favoritos adicionados recentemente.
bookmarks.getSubTree()-
Recupera uma parte da árvore de favoritos, iniciando por um nó previamente especificado.
bookmarks.getTree()-
Recupera a árvore de favoritos inteira em um array de objetos
BookmarkTreeNode. bookmarks.move()-
Move o especificado
BookmarkTreeNodepara um novo local dentro da árvore de favoritos. bookmarks.remove()-
Remove um favorito ou uma pasta de favoritos vazia dado o ID do nó.
bookmarks.removeTree()-
Remove recursivamente uma pasta de favoritos; isto é; dado o ID do nó da pasta e todos seus descendentes.
bookmarks.search()-
Procura por
BookmarkTreeNodes que batam com o conjunto de critérios especificados. bookmarks.update()-
Atualiza o título e/ou autor do favorito de uma URL, ou o nome de uma pasta de favoritos dado o ID do favorito.
Eventos
bookmarks.onCreated-
Disparado quando um favorito ou uma pasta é criado.
bookmarks.onRemoved-
Disparado quando um favorito ou uma pasta é removido. Quando uma pasta é removida recursivamente, uma simples notificação é disparada para o diretório, e nenhum para seu conteúdo.
bookmarks.onChanged-
Disparado quando um favorito ou pasta é modificado. Atualmente, somente mudanças no
titleeurlo disparam. bookmarks.onMoved-
Disparado quando um favorito ou pasta é movido para uma pasta pai diferente ou para um novo local dentro deste pasta.
bookmarks.onChildrenReordered-
Fired when the user has sorted the children of a folder in the browser's UI. This is not called as a result of a
move(). bookmarks.onImportBegan-
Disparado quando uma sessão de importação de favoritos começa. Custosos observers
bookmarks.onCreatedatualizam até obookmarks.onImportEndedser disparado. Observers deveriam ainda manipular outras notificações imediatamente. bookmarks.onImportEnded-
Disparado quando uma sessão de importação de favoritos é finalizada.
Compatibilidade com navegadores
Loading…
Example extensions
Nota:
AgradecimentosEsta API é baseada na API Chromium chrome.bookmarks . Esta documentação é derivada do bookmarks.json no código do Chromium.Os dados de compatibilidade do Microsoft Edge são fornecidos pela Microsoft Corporation e aqui estão sob a Creative Commons Attribution 3.0 United States License.