bookmarks.BookmarkTreeNode

bookmarks.BookmarkTreeNode 对象表示书签树中的一个节点,其中每个节点都是一个书签、一个书签文件夹或一个分隔符。子节点在其各自的父文件夹中按 index 排序。

类型

一个具有以下属性的 object

children 可选

一个 bookmarks.BookmarkTreeNode 对象的 array,表示节点的子节点。列表的顺序与子节点在用户界面中出现的顺序一致。如果节点不是文件夹,则此字段将被省略。

dateAdded 可选

一个数字,表示节点创建日期(以自纪元以来的毫秒数为单位)。

dateGroupModified 可选

一个数字,表示此文件夹内容上次更改的日期和时间(以自纪元以来的毫秒数为单位)。

id

一个 string,唯一标识该节点。每个 ID 在用户的配置文件中都是唯一的,并且在浏览器重启后保持不变。

index 可选

一个数字,表示该节点在其父文件夹中的零基位置,其中零表示第一个条目。

注意:如果您创建或移动多个书签,由于 bookmarks.create()bookmarks.move() 方法是异步的,因此请求可能以任何顺序进行处理。因此,直到所有请求都完成后,每个书签的索引值才可能更改或未知。如果与书签关联的索引对您的扩展很重要,那么——在创建或移动多个书签时——扩展应该等待每个 bookmarks.createbookmarks.move 调用完成后,再创建或移动下一个书签。等待可以确保每个书签的索引不受正在进行的原始调用期间并发执行的创建或移动调用的影响。

parentId 可选

一个 string,指定父文件夹的 ID。根节点不存在此属性。

title

一个 string,包含在菜单和书签列表中显示的节点文本。

type 可选

一个 bookmarks.BookmarkTreeNodeType 对象,指示这是一个书签、一个文件夹还是一个分隔符。默认为 "bookmark",除非省略了 url,在这种情况下,它默认为 "folder"

unmodifiable 可选

一个 string,如 bookmarks.BookmarkTreeNodeUnmodifiable 类型所述。表示节点无法更改的原因。如果节点可以更改,则省略此项。

url 可选

一个 string,表示书签的 URL。如果节点表示一个文件夹,则省略此属性。

浏览器兼容性

注意:此 API 基于 Chromium 的 chrome.bookmarks API。本文档来源于 Chromium 代码中的 bookmarks.json