Để sử dụng hầu hết các API chrome.*, API, tiện ích hoặc ứng dụng của bạn phải khai báo ý định trong trường "permissions" (quyền) của manifest (tệp kê khai). Mỗi quyền có thể là một trong danh sách các chuỗi đã biết (chẳng hạn như "geolocation") hoặc một mẫu khớp cấp quyền truy cập vào một hoặc nhiều máy chủ lưu trữ. Quyền giúp hạn chế thiệt hại nếu tiện ích hoặc ứng dụng của bạn bị phần mềm độc hại xâm phạm. Một số quyền cũng được hiển thị cho người dùng trước khi cài đặt, như trình bày chi tiết trong phần Cảnh báo về quyền.
Nếu một API yêu cầu bạn khai báo quyền trong tệp kê khai, thì tài liệu của API đó sẽ hướng dẫn bạn cách thực hiện. Ví dụ: trang Bộ nhớ hướng dẫn bạn cách khai báo quyền "bộ nhớ".
Dưới đây là ví dụ về phần quyền của tệp kê khai:
"permissions": [
"tabs",
"bookmarks",
"http://www.blogger.com/",
"http://*.google.com/",
"unlimitedStorage"
],
Bảng sau đây liệt kê các quyền hiện có:
| Quyền | Mô tả |
|---|---|
"activeTab" |
Yêu cầu cấp quyền cho tiện ích theo thông số kỹ thuật activeTab. |
"alarms" |
Cấp cho tiện ích của bạn quyền truy cập vào API chrome.alarms. |
"background" |
Giúp Chrome khởi động sớm và tắt muộn để các ứng dụng và tiện ích có thể hoạt động lâu hơn. Khi bất kỳ ứng dụng được lưu trữ, ứng dụng đóng gói hoặc tiện ích nào đã cài đặt có quyền "nền", Chrome sẽ chạy (vô hình) ngay khi người dùng đăng nhập vào máy tính của họ — trước khi người dùng khởi chạy Chrome. Quyền "nền" cũng giúp Chrome tiếp tục chạy (ngay cả sau khi cửa sổ cuối cùng đóng) cho đến khi người dùng thoát khỏi Chrome một cách rõ ràng. Lưu ý: Các ứng dụng và tiện ích bị tắt được coi như chưa được cài đặt.
Bạn thường sử dụng quyền "nền" với trang nền, trang sự kiện hoặc (đối với ứng dụng được lưu trữ) cửa sổ nền. |
"bookmarks" |
Cấp cho tiện ích của bạn quyền truy cập vào API chrome.bookmarks. |
"browsingData" |
Cấp cho tiện ích của bạn quyền truy cập vào API chrome.browsingData. |
"certificateProvider" |
Cấp cho tiện ích của bạn quyền truy cập vào API chrome.certificateProvider. |
"clipboardRead" |
Bắt buộc nếu tiện ích hoặc ứng dụng sử dụng document.execCommand('paste'). |
"clipboardWrite" |
Cho biết tiện ích hoặc ứng dụng sử dụng document.execCommand('copy') hoặc document.execCommand('cut'). Quyền này bắt buộc đối với ứng dụng được lưu trữ; bạn nên dùng quyền này cho tiện ích và ứng dụng đóng gói. |
"contentSettings" |
Cấp cho tiện ích của bạn quyền truy cập vào API chrome.contentSettings. |
"contextMenus" |
Cấp cho tiện ích của bạn quyền truy cập vào API chrome.contextMenus. |
"cookies" |
Cấp cho tiện ích của bạn quyền truy cập vào API chrome.cookies. |
"debugger" |
Cấp cho tiện ích của bạn quyền truy cập vào API chrome.debugger. |
"declarativeContent" |
Cấp cho tiện ích của bạn quyền truy cập vào API chrome.declarativeContent. |
"declarativeNetRequest" |
Cấp cho tiện ích của bạn quyền truy cập vào API chrome.declarativeNetRequest. |
"declarativeNetRequestFeedback" |
Cấp cho tiện ích quyền truy cập vào các sự kiện và phương thức trong API chrome.declarativeNetRequest, giúp trả về thông tin về các quy tắc khai báo phù hợp. |
"declarativeWebRequest" |
Cấp cho tiện ích của bạn quyền truy cập vào API chrome.declarativeWebRequest. |
"desktopCapture" |
Cấp cho tiện ích của bạn quyền truy cập vào API chrome.desktopCapture. |
"documentScan" |
Cấp cho tiện ích của bạn quyền truy cập vào API chrome.documentScan. |
"downloads" |
Cấp cho tiện ích của bạn quyền truy cập vào API chrome.downloads. |
"enterprise.deviceAttributes" |
Cấp cho tiện ích của bạn quyền truy cập vào API chrome.enterprise.deviceAttributes. |
"enterprise.hardwarePlatform" |
Cấp cho tiện ích của bạn quyền truy cập vào API chrome.enterprise.hardwarePlatform. |
"enterprise.networkingAttributes" |
Cấp cho tiện ích của bạn quyền truy cập vào API chrome.enterprise.networkingAttributes. |
"enterprise.platformKeys" |
Cấp cho tiện ích của bạn quyền truy cập vào API chrome.enterprise.platformKeys. |
"experimental" |
Bắt buộc nếu tiện ích hoặc ứng dụng sử dụng bất kỳ API chrome.experimental.* API. |
"fileBrowserHandler" |
Cấp cho tiện ích của bạn quyền truy cập vào API chrome.fileBrowserHandler. |
"fileSystemProvider" |
Cấp cho tiện ích của bạn quyền truy cập vào API chrome.fileSystemProvider. |
"fontSettings" |
Cấp cho tiện ích của bạn quyền truy cập vào API chrome.fontSettings. |
"gcm" |
Cấp cho tiện ích của bạn quyền truy cập vào API chrome.gcm. |
"geolocation" |
Cho phép tiện ích hoặc ứng dụng sử dụng API vị trí địa lý mà không cần nhắc người dùng cấp quyền. |
"history" |
Cấp cho tiện ích của bạn quyền truy cập vào API chrome.history. |
"identity" |
Cấp cho tiện ích của bạn quyền truy cập vào API chrome.identity. |
"idle" |
Cấp cho tiện ích của bạn quyền truy cập vào API chrome.idle. |
"loginState" |
Cấp cho tiện ích của bạn quyền truy cập vào API chrome.loginState. |
"management" |
Cấp cho tiện ích của bạn quyền truy cập vào API chrome.management. |
"nativeMessaging" |
Cấp cho tiện ích của bạn quyền truy cập vào API nhắn tin gốc. |
"notifications" |
Cấp cho tiện ích của bạn quyền truy cập vào API chrome.notifications. |
"pageCapture" |
Cấp cho tiện ích của bạn quyền truy cập vào API chrome.pageCapture. |
"platformKeys" |
Cấp cho tiện ích của bạn quyền truy cập vào API chrome.platformKeys. |
"power" |
Cấp cho tiện ích của bạn quyền truy cập vào API chrome.power. |
"printerProvider" |
Cấp cho tiện ích của bạn quyền truy cập vào API chrome.printerProvider. |
"printing" |
Cấp cho tiện ích của bạn quyền truy cập vào API chrome.printing. |
"printingMetrics" |
Cấp cho tiện ích của bạn quyền truy cập vào API chrome.printingMetrics. |
"privacy" |
Cấp cho tiện ích của bạn quyền truy cập vào API chrome.privacy. |
"processes" |
Cấp cho tiện ích của bạn quyền truy cập vào API chrome.processes. |
"proxy" |
Cấp cho tiện ích của bạn quyền truy cập vào API chrome.proxy. |
"scripting" |
Cấp cho tiện ích của bạn quyền truy cập vào API chrome.scripting. |
"search" |
Cấp cho tiện ích của bạn quyền truy cập vào API chrome.search. |
"sessions" |
Cấp cho tiện ích của bạn quyền truy cập vào API chrome.sessions. |
"signedInDevices" |
Cấp cho tiện ích của bạn quyền truy cập vào API chrome.signedInDevices. |
"storage" |
Cấp cho tiện ích của bạn quyền truy cập vào API chrome.storage. |
"system.cpu" |
Cấp cho tiện ích của bạn quyền truy cập vào API chrome.system.cpu. |
"system.display" |
Cấp cho tiện ích của bạn quyền truy cập vào API chrome.system.display. |
"system.memory" |
Cấp cho tiện ích của bạn quyền truy cập vào API chrome.system.memory. |
"system.storage" |
Cấp cho tiện ích của bạn quyền truy cập vào API chrome.system.storage. |
"tabCapture" |
Cấp cho tiện ích của bạn quyền truy cập vào API chrome.tabCapture. |
"tabGroups" |
Cấp cho tiện ích của bạn quyền truy cập vào API chrome.tabGroups. |
"tabs" |
Cấp cho tiện ích của bạn quyền truy cập vào các trường đặc quyền của đối tượng Tab mà một số API sử dụng, bao gồm cả chrome.tabs và chrome.windows. Trong nhiều trường hợp, tiện ích của bạn sẽ không cần khai báo quyền "tabs" để sử dụng các API này. |
"topSites" |
Cấp cho tiện ích của bạn quyền truy cập vào API chrome.topSites. |
"tts" |
Cấp cho tiện ích của bạn quyền truy cập vào API chrome.tts. |
"ttsEngine" |
Cấp cho tiện ích của bạn quyền truy cập vào API chrome.ttsEngine. |
"unlimitedStorage" |
Cung cấp hạn mức không giới hạn để lưu trữ dữ liệu phía máy khách, chẳng hạn như cơ sở dữ liệu và tệp lưu trữ cục bộ.
Nếu không có quyền này, tiện ích hoặc ứng dụng chỉ có thể sử dụng tối đa 5 MB bộ nhớ cục bộ. Lưu ý: Quyền này chỉ áp dụng cho Cơ sở dữ liệu SQL web và bộ nhớ đệm của ứng dụng (xem vấn đề 58985). Ngoài ra, tính năng này hiện không hoạt động với các miền con ký tự đại diện như
http://*.example.com. |
"vpnProvider" |
Cấp cho tiện ích của bạn quyền truy cập vào API chrome.vpnProvider. |
"webNavigation" |
Cấp cho tiện ích của bạn quyền truy cập vào API chrome.webNavigation. |
"webRequest" |
Cấp cho tiện ích của bạn quyền truy cập vào API chrome.webRequest. |
"webRequestBlocking" |
Bắt buộc nếu tiện ích sử dụng API chrome.webRequest theo cách chặn. |