Để sử dụng hầu hết các tính năng của Chrome.* API, tiện ích hoặc ứng dụng của bạn phải khai báo ý định trong trường "quyền" của manifest. Mỗi quyền có thể là một trong danh sách các chuỗi đã biết (chẳng hạn như "định vị địa lý") 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ủ. Các quyền giúp hạn chế thiệt hại nếu phần mở rộng 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ư được nêu 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ẽ cho bạn biết cách khai báo. Ví dụ: trang Bộ nhớ cho bạn biết 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 của 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 cài đặt có quyền "ở chế độ nền", Chrome sẽ chạy (ở chế độ ẩn) 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 "ở chế độ 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 Chrome một cách rõ ràng. Lưu ý: Các ứng dụng và tiện ích bị tắt sẽ được coi là chưa được cài đặt.
Bạn thường sử dụng quyền "ở chế độ 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 sử dụng quyền này cho các tiện ích và ứng dụng đóng gói. |
"contentSettings" |
Cấp cho tiện ích 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. API này sẽ trả về thông tin về các quy tắc khai báo được so khớ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ỳ chrome.experimental.* nào 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 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 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 bộ nhớ cục bộ.
Nếu không có quyền này, tiện ích hoặc ứng dụng sẽ bị giới hạn ở 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. |
"wallpaper" |
Cấp cho tiện ích của bạn quyền truy cập vào API chrome.wallpaper. |
"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. |