Trang này được dịch bởi Cloud Translation API.

chrome.bookmarks

Mô tả

Sử dụng API chrome.bookmarks để tạo, sắp xếp và thao tác với dấu trang. Bạn cũng có thể xem Override Pages (Ghi đè trang) mà bạn có thể dùng để tạo một trang Trình quản lý dấu trang tuỳ chỉnh.

Khi bạn nhấp vào dấu sao, một dấu trang sẽ được thêm.

Quyền

bookmarks

Bạn phải khai báo quyền "bookmarks" trong tệp kê khai tiện ích để sử dụng API dấu trang. Ví dụ:

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

Khái niệm và cách sử dụng

Đối tượng và thuộc tính

Dấu trang được sắp xếp theo dạng cây, trong đó mỗi nút trong cây là một dấu trang hoặc một thư mục (đôi khi được gọi là nhóm). Mỗi nút trong cây được biểu thị bằng một đối tượng bookmarks.BookmarkTreeNode.

Các thuộc tính BookmarkTreeNode được dùng trong toàn bộ API chrome.bookmarks. Ví dụ: khi gọi bookmarks.create, bạn sẽ truyền vào nút mẹ của nút mới (parentId) và tuỳ ý truyền vào các thuộc tính index, title và url của nút. Hãy xem bookmarks.BookmarkTreeNode để biết thông tin về các thuộc tính mà một nút có thể có.

Ví dụ

Đoạn mã sau đây sẽ tạo một thư mục có tiêu đề "Dấu trang của tiện ích". Đối số đầu tiên cho create() chỉ định các thuộc tính cho thư mục mới. Đối số thứ hai xác định một hàm sẽ được thực thi sau khi thư mục được tạo.

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

Đoạn mã tiếp theo sẽ tạo một dấu trang trỏ đến tài liệu dành cho nhà phát triển về các tiện ích. Vì không có vấn đề gì xảy ra nếu không tạo được dấu trang, nên mã này không cần xác định hàm gọi lại.

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

Để dùng thử API này, hãy cài đặt ví dụ về Bookmarks API từ kho lưu trữ chrome-extension-samples.

Loại

BookmarkTreeNode

Một nút (dấu trang hoặc thư mục) trong cây dấu trang. Các nút con được sắp xếp theo thứ tự trong thư mục mẹ.

Thuộc tính

trẻ em

BookmarkTreeNode[] không bắt buộc

Danh sách các phần tử con theo thứ tự của nút này.
dateAdded

number không bắt buộc

Thời điểm nút này được tạo, tính bằng mili giây kể từ thời gian bắt đầu của hệ thống (new Date(dateAdded)).
dateGroupModified

number không bắt buộc

Thời điểm nội dung của thư mục này thay đổi lần gần đây nhất, tính bằng mili giây kể từ thời gian bắt đầu của hệ thống.
dateLastUsed

number không bắt buộc

Chrome 114 trở lên

Thời điểm nút này được mở lần gần đây nhất, tính bằng mili giây kể từ thời gian bắt đầu của hệ thống. Không được đặt cho thư mục.
folderType

FolderType không bắt buộc

Chrome 134 trở lên

Nếu có, đây là một thư mục do trình duyệt thêm vào và người dùng hoặc tiện ích không thể sửa đổi thư mục này. Bạn có thể sửa đổi các nút con nếu nút này không có thuộc tính unmodifiable được đặt. Bị bỏ qua nếu người dùng và tiện ích có thể sửa đổi nút (mặc định).

Có thể không có, có một hoặc nhiều nút của từng loại thư mục. Trình duyệt có thể thêm hoặc xoá một thư mục, nhưng không thể thực hiện việc này thông qua API tiện ích.
id

chuỗi

Giá trị nhận dạng duy nhất của nút. Các mã nhận dạng này là duy nhất trong hồ sơ hiện tại và vẫn hợp lệ ngay cả sau khi trình duyệt khởi động lại.
index

number không bắt buộc

Vị trí dựa trên 0 của nút này trong thư mục mẹ.
parentId

chuỗi không bắt buộc

id của thư mục mẹ. Bỏ qua cho nút gốc.
đang đồng bộ hoá

boolean

Chrome 134 trở lên

Trình duyệt có đồng bộ hoá nút này với bộ nhớ tài khoản từ xa của người dùng hay không. Bạn có thể dùng thuộc tính này để phân biệt giữa phiên bản chỉ có tài khoản và phiên bản chỉ có tại địa phương của cùng một FolderType. Giá trị của thuộc tính này có thể thay đổi đối với một nút hiện có, chẳng hạn như do hành động của người dùng.

Lưu ý: điều này phản ánh việc nút có được lưu vào trình cung cấp tài khoản tích hợp sẵn của trình duyệt hay không. Có thể một nút được đồng bộ hoá thông qua bên thứ ba, ngay cả khi giá trị này là false.

Đối với các nút được quản lý (các nút mà unmodifiable được đặt thành true), thuộc tính này sẽ luôn là false.
tiêu đề

chuỗi

Văn bản xuất hiện cho nút.
không thể sửa đổi

"managed"
không bắt buộc

Cho biết lý do khiến bạn không thể sửa đổi nút này. Giá trị managed cho biết nút này được quản trị viên hệ thống hoặc người giám hộ của người dùng được giám sát định cấu hình. Bị bỏ qua nếu người dùng và tiện ích có thể sửa đổi nút (mặc định).
url

chuỗi không bắt buộc

URL được chuyển hướng đến khi người dùng nhấp vào dấu trang. Không áp dụng cho thư mục.

BookmarkTreeNodeUnmodifiable

Chrome 44 trở lên

Cho biết lý do khiến bạn không thể sửa đổi nút này. Giá trị managed cho biết quản trị viên hệ thống đã định cấu hình nút này. Bị bỏ qua nếu người dùng và tiện ích có thể sửa đổi nút (mặc định).

Giá trị

"được quản lý"

CreateDetails

Đối tượng được truyền đến hàm create().

Thuộc tính

index

number không bắt buộc
parentId

chuỗi không bắt buộc

Theo mặc định, dấu trang sẽ được lưu vào thư mục Dấu trang khác.
tiêu đề

chuỗi không bắt buộc
url

chuỗi không bắt buộc

FolderType

Chrome 134 trở lên

Cho biết loại thư mục.

Enum

"bookmarks-bar"
Thư mục có nội dung xuất hiện ở đầu cửa sổ trình duyệt.

"khác"
Dấu trang xuất hiện trong danh sách đầy đủ các dấu trang trên mọi nền tảng.

"mobile"
Dấu trang thường có trên thiết bị di động của người dùng, nhưng có thể được sửa đổi bằng tiện ích hoặc trong trình quản lý dấu trang.

"được quản lý"
Thư mục cấp cao nhất có thể xuất hiện nếu quản trị viên hệ thống hoặc người giám hộ của người dùng được giám sát đã định cấu hình dấu trang.

Thuộc tính

MAX_SUSTAINED_WRITE_OPERATIONS_PER_MINUTE

Không dùng nữa

Chrome không còn giới hạn các thao tác ghi dấu trang nữa.

Giá trị

1000000

MAX_WRITE_OPERATIONS_PER_HOUR

Không dùng nữa

Chrome không còn giới hạn các thao tác ghi dấu trang nữa.

Giá trị

1000000

Phương thức

create()

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

Tạo một dấu trang hoặc thư mục trong parentId đã chỉ định. Nếu url là NULL hoặc bị thiếu, thì đó sẽ là một thư mục.

Thông số

dấu trang

CreateDetails

Giá trị trả về

Promise<BookmarkTreeNode>

Chrome 90 trở lên

get()

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

Truy xuất(các) BookmarkTreeNode được chỉ định.

Thông số

idOrIdList

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

Một mã nhận dạng duy nhất có giá trị là chuỗi hoặc một mảng mã nhận dạng có giá trị là chuỗi

Giá trị trả về

Promise<BookmarkTreeNode[]>

Chrome 90 trở lên

getChildren()

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

Truy xuất các phần tử con của mã nhận dạng BookmarkTreeNode đã chỉ định.

Thông số

id

chuỗi

Giá trị trả về

Promise<BookmarkTreeNode[]>

Chrome 90 trở lên

getRecent()

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

Truy xuất các dấu trang được thêm gần đây.

Thông số

numberOfItems

số

Số lượng mục tối đa cần trả về.

Giá trị trả về

Promise<BookmarkTreeNode[]>

Chrome 90 trở lên

getSubTree()

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

Truy xuất một phần của hệ phân cấp Dấu trang, bắt đầu từ nút được chỉ định.

Thông số

id

chuỗi

Mã nhận dạng của gốc của cây con cần truy xuất.

Giá trị trả về

Promise<BookmarkTreeNode[]>

Chrome 90 trở lên

getTree()

chrome.bookmarks.getTree(): Promise<BookmarkTreeNode[]>

Truy xuất toàn bộ hệ thống phân cấp Dấu trang.

Giá trị trả về

Promise<BookmarkTreeNode[]>

Chrome 90 trở lên

move()

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

Di chuyển BookmarkTreeNode đã chỉ định đến vị trí được cung cấp.

Thông số

id

chuỗi
tài khoản đích

đối tượng
- index
  
  number không bắt buộc
- parentId
  
  chuỗi không bắt buộc

Giá trị trả về

Promise<BookmarkTreeNode>

Chrome 90 trở lên

remove()

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

Xoá một dấu trang hoặc thư mục dấu trang trống.

Thông số

id

chuỗi

Giá trị trả về

Promise<void>

Chrome 90 trở lên

removeTree()

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

Xoá đệ quy một thư mục dấu trang.

Thông số

id

chuỗi

Giá trị trả về

Promise<void>

Chrome 90 trở lên

search()

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

Tìm kiếm BookmarkTreeNode khớp với truy vấn đã cho. Các truy vấn được chỉ định bằng một đối tượng sẽ tạo ra các BookmarkTreeNode khớp với tất cả các thuộc tính được chỉ định.

Thông số

truy vấn

string | object

Có thể là một chuỗi các từ và cụm từ được đặt trong dấu ngoặc kép được so khớp với URL và tiêu đề của dấu trang, hoặc là một đối tượng. Nếu là một đối tượng, bạn có thể chỉ định các thuộc tính query, url và title, đồng thời các dấu trang khớp với tất cả thuộc tính đã chỉ định sẽ được tạo.
- truy vấn
  
  chuỗi không bắt buộc
  
  Một chuỗi các từ và cụm từ trong dấu ngoặc kép được so khớp với URL và tiêu đề của dấu trang.
- tiêu đề
  
  chuỗi không bắt buộc
  
  Tiêu đề của dấu trang; khớp nguyên văn.
- url
  
  chuỗi không bắt buộc
  
  URL của dấu trang; khớp nguyên văn. Xin lưu ý rằng thư mục không có URL.

Giá trị trả về

Promise<BookmarkTreeNode[]>

Chrome 90 trở lên

update()

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

Cập nhật các thuộc tính của một dấu trang hoặc thư mục. Chỉ định những thuộc tính mà bạn muốn thay đổi; các thuộc tính không được chỉ định sẽ không thay đổi. Lưu ý: Hiện tại, chỉ có "title" và "url" được hỗ trợ.

Thông số

id

chuỗi
các thay đổi

đối tượng
- tiêu đề
  
  chuỗi không bắt buộc
- url
  
  chuỗi không bắt buộc

Giá trị trả về

Promise<BookmarkTreeNode>

Chrome 90 trở lên

Sự kiện

onChanged

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

Được kích hoạt khi một dấu trang hoặc thư mục thay đổi. Lưu ý: Hiện tại, chỉ những thay đổi về tiêu đề và URL mới kích hoạt tính năng này.

Thông số

callback

hàm

Tham số callback có dạng như sau:
```
(id: string, changeInfo: object) => void
```
- id
  
  chuỗi
- changeInfo
  
  đối tượng
  - tiêu đề
    
    chuỗi
  - url
    
    chuỗi không bắt buộc

onChildrenReordered

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

Được kích hoạt khi các thành phần con của một thư mục đã thay đổi thứ tự do thứ tự được sắp xếp trong giao diện người dùng. Hàm này không được gọi do move().

Thông số

callback

hàm

Tham số callback có dạng như sau:
```
(id: string, reorderInfo: object) => void
```
- id
  
  chuỗi
- reorderInfo
  
  đối tượng
  - childIds
    
    string[]

onCreated

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

Được kích hoạt khi một dấu trang hoặc thư mục được tạo.

Thông số

callback

hàm

Tham số callback có dạng như sau:
```
(id: string, bookmark: BookmarkTreeNode) => void
```
- id
  
  chuỗi
- dấu trang
  
  BookmarkTreeNode

onImportBegan

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

Được kích hoạt khi bắt đầu một phiên nhập dấu trang. Các đối tượng theo dõi tốn nhiều tài nguyên nên bỏ qua các bản cập nhật onCreated cho đến khi onImportEnded được kích hoạt. Các đối tượng theo dõi vẫn phải xử lý ngay các thông báo khác.

Thông số

callback

hàm

Tham số callback có dạng như sau:
```
() => void
```

onImportEnded

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

Được kích hoạt khi một phiên nhập dấu trang kết thúc.

Thông số

callback

hàm

Tham số callback có dạng như sau:
```
() => void
```

onMoved

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

Sự kiện này xảy ra khi một dấu trang hoặc thư mục được di chuyển sang một thư mục mẹ khác.

Thông số

callback

hàm

Tham số callback có dạng như sau:
```
(id: string, moveInfo: object) => void
```
- id
  
  chuỗi
- moveInfo
  
  đối tượng
  - index
    
    số
  - oldIndex
    
    số
  - oldParentId
    
    chuỗi
  - parentId
    
    chuỗi

onRemoved

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

Được kích hoạt khi một dấu trang hoặc thư mục bị xoá. Khi một thư mục bị xoá đệ quy, một thông báo duy nhất sẽ được gửi cho thư mục đó và không có thông báo nào cho nội dung của thư mục.

Thông số

callback

hàm

Tham số callback có dạng như sau:
```
(id: string, removeInfo: object) => void
```
- id
  
  chuỗi
- removeInfo
  
  đối tượng
  - index
    
    số
  - nút
    
    BookmarkTreeNode
    
    Chrome 48 trở lên
  - parentId
    
    chuỗi

chrome.bookmarks Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.

Mô tả

Quyền

Khái niệm và cách sử dụng

Đối tượng và thuộc tính

Ví dụ

Loại

BookmarkTreeNode

Thuộc tính

BookmarkTreeNodeUnmodifiable

Giá trị

CreateDetails

Thuộc tính

FolderType

Enum

Thuộc tính

MAX_SUSTAINED_WRITE_OPERATIONS_PER_MINUTE

Giá trị

MAX_WRITE_OPERATIONS_PER_HOUR

Giá trị

Phương thức

create()

Thông số

Giá trị trả về

get()

Thông số

Giá trị trả về

getChildren()

Thông số

Giá trị trả về

getRecent()

Thông số

Giá trị trả về

getSubTree()

Thông số

Giá trị trả về

getTree()

Giá trị trả về

move()

Thông số

Giá trị trả về

remove()

Thông số

Giá trị trả về

removeTree()

Thông số

Giá trị trả về

search()

Thông số

Giá trị trả về

update()

Thông số

Giá trị trả về

Sự kiện

onChanged

Thông số

onChildrenReordered

Thông số

onCreated

Thông số

onImportBegan

Thông số

onImportEnded

Thông số

onMoved

Thông số

onRemoved

Thông số

chrome.bookmarks