Cách sử dụng hầu hết Chrome.* Các 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 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ư "vị trí địa lý") hoặc mẫu so 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 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ư nêu chi tiết trong Cảnh báo 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 việc này. Ví dụ: trang Bộ nhớ sẽ 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 | Nội dung 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ữ đã cài đặt, ứng dụng đóng gói hoặc tiện ích nào có quyền "ở chế độ nền", Chrome sẽ chạy (ẩn) ngay sau khi người dùng đăng nhập vào máy tính — trước khi người dùng 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 đã tắt sẽ được coi là chưa được cài đặt.
Bạn thường dùng quyền "nền" với trang nền, trang sự kiện hoặc cửa sổ nền (đối với ứng dụng được lưu trữ). |
"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" |
Đây là trường 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 là bắt buộc đối với ứng dụng được lưu trữ; nên dùng cho các 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. API này trả về thông tin về các quy tắc khai báo 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 định vị đị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 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 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 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 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 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 những 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 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 web SQL 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 có 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. |