chrome.permissions

Nội dung mô tả

Khái niệm và cách sử dụng

Cảnh báo về quyền được dùng để mô tả những chức năng mà 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à dần dần giới thiệu các tính năng mới, qua đó giới thiệu tiện ích này cho người dùng mà không có rủi ro. Bằng cách này, người dùng có thể chỉ định mức độ truy cập mà họ sẵn sàng cấp và những tính năng 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ớ, không kèm theo 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 đây:

Việc hiển thị các trang web hàng đầu của người dùng cần có quyền topSites. Quyền này có cảnh báo sau.

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

Bước 1: Xác định những quyền nào là cần thiết và những quyền 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:

• Sử dụng các quyền cần thiết khi cần thiết để thực hiện 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 cho các tính năng không bắt buộc trong tiện ích của bạn.

Ư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: Chúng tôi đả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 các quyền cần thiết.
• Cung cấp thông tin hữu ích 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 tắt tiện ích đó cho người dùng nếu bản nâng cấp thêm các quyền tuỳ chọn thay vì các quyền bắt buộc.

Bước 2: Khai báo 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ỉ khám phá 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ó giao thức phù hợp.

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

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

Vui lòng xem phần Khai báo quyền để biết thêm thông tin về các quyền hiện có và cảnh báo về các quyền đó.

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

Yêu cầu cấp quyền từ trong cử chỉ của người dùng bằ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 những gì người dùng đã nhìn thấy và chấp nhận. Ví dụ: mã trước đó có thể dẫn đến lời nhắc như sau:

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

Để kiểm tra xem tiện ích có quyền hoặc nhóm 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 xoá quyền khi không cần đến nữa. Sau khi xoá một quyền, việc gọi permissions.request() thường thêm lại quyền đó 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,
)