chrome.permissions

Mô tả

Tổng quan

Cảnh báo quyền tồn tại để mô tả các khả năng do API cấp, nhưng một số cảnh báo trong số này có thể không rõ ràng. API Quyền cho phép nhà phát triển giải thích các cảnh báo về quyền và từng bước giới thiệu các tính năng mới, giúp người dùng được giới thiệu tiện ích mà không có rủi ro. Bằng cách này, người dùng có thể chỉ định mức quyền truy cập mà họ sẵn sàng cấp và những tính năng mà họ muốn bật.

Ví dụ: chức năng cốt lõi của tiện ích quyền không bắt buộc là ghi đè trang thẻ mới. Một tính năng đang hiển thị mục tiêu trong ngày của người dùng. Tính năng này chỉ yêu cầu quyền bộ nhớ và không có cảnh báo. Tiện ích này có một tính năng bổ sung mà người dùng có thể bật bằng cách nhấp vào nút sau:

Để hiển thị các trang web hàng đầu của người dùng, bạn cần có quyền topSites và kèm theo cảnh báo sau.

Triển khai các quyền không bắt buộc

Bước 1: Quyết định quyền nào là bắt buộc và quyền nào là không bắt buộc

Tiện ích có thể khai báo cả quyền bắt buộc và quyền không bắt buộc. Nói chung, bạn nên:

• Bạn có thể dùng các quyền cần thiết khi cần thiết cho chức năng cơ bản của tiện ích.
• Sử dụng các quyền không bắt buộc khi cần thiết cho những tính năng không bắt buộc trong tiện ích.

Ưu điểm của các quyền bắt buộc:

• Ít lời nhắc hơn: Tiện ích có thể nhắc người dùng một lần để chấp nhận tất cả các quyền.
• Phát triển đơn giản hơn: Đảm bảo có các quyền bắt buộc.

Ưu điểm của quyền không bắt buộc:

• Bảo mật tốt hơn: Tiện ích chạy với ít quyền hơn vì người dùng chỉ cấp quyền cần thiết.
• Thông tin tốt hơn cho người dùng: Tiện ích có thể giải thích lý do tiện ích cần một quyền cụ thể khi người dùng bật tính năng có liên quan.
• Nâng cấp dễ dàng hơn: Khi bạn nâng cấp tiện ích, Chrome sẽ không vô hiệu hoá tiện ích đó đối với người dùng nếu bản nâng cấp sẽ thêm các quyền không bắt buộc thay vì bắt buộc.

Bước 2: Khai báo các quyền không bắt buộc trong tệp kê khai

Khai báo các quyền không bắt buộc trong tệp kê khai tiện ích bằng khoá optional_permissions, sử dụng định dạng giống như trường quyền:

{
  "name": "My extension",
  ...
  "optional_permissions": ["tabs"],
  "optional_host_permissions": ["https://www.google.com/"],
  ...
}

Nếu bạn muốn yêu cầu các máy chủ mà bạn chỉ phát hiện trong thời gian chạy, hãy thêm "https://*/*" vào trường optional_host_permissions của tiện ích. Thao tác này cho phép bạn chỉ định mọi nguồn gốc trong Permissions.origins, miễn là nguồn gốc đó có một phần trùng khớp hệ thống.

Các quyền không có thể được chỉ định là không bắt buộc

Bạn có thể chỉ định hầu hết các quyền đối với tiện ích của Chrome là không bắt buộc, trừ những trường hợp ngoại lệ sau.

Xem bài viết Khai báo quyền và cảnh báo người dùng để biết thêm thông tin về các quyền hiện có và các cảnh báo của họ.

Bước 3: Yêu cầu cấp các quyền không bắt buộc

Yêu cầu cấp quyền ngay trong một cử chỉ của người dùng bằng cách sử dụng permissions.request():

document.querySelector('#my-button').addEventListener('click', (event) => {
  // Permissions must be requested from inside a user gesture, like a button's
  // click handler.
  chrome.permissions.request({
    permissions: ['tabs'],
    origins: ['https://www.google.com/']
  }, (granted) => {
    // The callback argument will be true if the user granted the permissions.
    if (granted) {
      doSomething();
    } else {
      doSomethingElse();
    }
  });
});

Chrome sẽ nhắc người dùng nếu việc thêm quyền dẫn đến thông báo cảnh báo khác với mà người dùng đã xem và chấp nhận. Ví dụ: đoạn mã trước đó có thể đưa ra lời nhắc như sau:

Bước 4: Kiểm tra các quyền hiện tại của tiện ích

Để kiểm tra xem tiện ích của bạn có quyền hoặc tập hợp quyền cụ thể hay không, hãy sử dụng permission.contains():

chrome.permissions.contains({
  permissions: ['tabs'],
  origins: ['https://www.google.com/']
}, (result) => {
  if (result) {
    // The extension has the permissions.
  } else {
    // The extension doesn't have the permissions.
  }
});

Bước 5: Thu hồi quyền

Bạn nên thu hồi quyền khi không cần nữa. Sau khi bạn xoá một quyền, thường thì việc gọi permissions.request() sẽ thêm quyền trở lại mà không nhắc người dùng.

chrome.permissions.remove({
  permissions: ['tabs'],
  origins: ['https://www.google.com/']
}, (removed) => {
  if (removed) {
    // The permissions have been removed.
  } else {
    // The permissions have not been removed (e.g., you tried to remove
    // required permissions).
  }
});

chrome.permissions.contains(
  permissions: Permissions,
  callback?: function,
)

chrome.permissions.getAll(
  callback?: function,
)

chrome.permissions.remove(
  permissions: Permissions,
  callback?: function,
)

chrome.permissions.request(
  permissions: Permissions,
  callback?: function,
)

chrome.permissions.onAdded.addListener(
  callback: function,
)

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