Khai báo quyền

Sử dụng hầu hết các ứng dụng Chrome.* API, tiện ích hoặc ứng dụng của bạn phải khai báo ý định trong phần "quyền" trường 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ư "geolocation") hoặc 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 xuất hiện cho người dùng trước khi cài đặt, như được nêu chi tiết trong Cảnh báo về quyền.

Nếu một API yêu cầu bạn khai báo một quyền trong tệp kê khai, thì tài liệu của API đó sẽ hướng dẫn bạn cách để làm điều đó. Ví dụ: trang Bộ nhớ cho bạn biết cách khai báo "bộ nhớ" quyền.

Dưới đây là ví dụ về phần quyền trong 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 activeTab đặc điểm kỹ thuật.
"alarms" Cấp cho tiện ích của bạn quyền truy cập vào API chrome.alarms.
"background"

Khiến Chrome khởi động sớm và tắt muộn để các ứng dụng và tiện ích có thể khởi động lâu hơn cuộc sống.

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ó "nền" quyền, Chrome sẽ chạy (ẩ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. "Nền" quyền cũng làm cho 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 thể hiện rõ ràng thoát Chrome.

Lưu ý: Ứng dụng và tiện ích đã tắt được xử lý như thể chúng không thực sự khác .

Bạn thường sử dụng "phông nền" quyền truy cập thông qua một trang nền, trang sự kiện hoặc một 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" 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') Đây là quyền bắt buộc đối với các ứng dụng được lưu trữ; bạn nên 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 khai báo khớp với quy tắc.
"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 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 dùng API định vị địa lý mà không cần nhắc người dùng 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.
"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 chrome.tabschrome.windows. Trong 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 cho việc 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 ký tự đại diện các miền con 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 phương thức chặn.