Untuk menggunakan sebagian besar Chrome.* API, ekstensi atau aplikasi Anda harus mendeklarasikan intent-nya di kolom "izin" pada manifes. Setiap izin dapat berupa salah satu daftar string yang diketahui (seperti "geolokasi") atau pola kecocokan yang memberikan akses ke satu atau beberapa host. Izin membantu membatasi kerusakan jika ekstensi atau aplikasi Anda disusupi oleh malware. Beberapa izin juga ditampilkan kepada pengguna sebelum penginstalan, seperti yang dijelaskan dalam Peringatan Izin.
Jika API mengharuskan Anda mendeklarasikan izin dalam manifes, dokumentasinya akan memberi tahu Anda cara melakukannya. Misalnya, halaman Penyimpanan menunjukkan cara mendeklarasikan izin "penyimpanan".
Berikut adalah contoh bagian izin dari file manifes:
"permissions": [
"tabs",
"bookmarks",
"http://www.blogger.com/",
"http://*.google.com/",
"unlimitedStorage"
],
Tabel berikut mencantumkan izin yang saat ini tersedia:
| Izin | Deskripsi |
|---|---|
"activeTab" |
Meminta agar ekstensi diberi izin sesuai dengan spesifikasi activeTab. |
"alarms" |
Memberi ekstensi Anda akses ke chrome.alarms API. |
"background" |
Membuat Chrome dimulai lebih awal dan dimatikan terlambat, sehingga aplikasi dan ekstensi dapat memiliki masa pakai yang lebih lama. Jika aplikasi terinstal, aplikasi terpaket, atau ekstensi yang terinstal memiliki izin "latar belakang", Chrome akan berjalan (secara tidak terlihat) segera setelah pengguna login ke komputer—sebelum pengguna meluncurkan Chrome. Izin "latar belakang" juga membuat Chrome terus berjalan (bahkan setelah jendela terakhir ditutup) hingga pengguna secara eksplisit keluar dari Chrome. Catatan: Aplikasi dan ekstensi yang dinonaktifkan akan diperlakukan seolah-olah tidak
diinstal.
Anda biasanya menggunakan izin "latar belakang" dengan halaman latar belakang, halaman peristiwa, atau (untuk aplikasi yang dihosting) jendela latar belakang. |
"bookmarks" |
Memberi ekstensi Anda akses ke API chrome.bookmarks. |
"browsingData" |
Memberi ekstensi Anda akses ke API chrome.browsingData. |
"certificateProvider" |
Memberi ekstensi Anda akses ke chrome.certificateProvider API. |
"clipboardRead" |
Wajib jika ekstensi atau aplikasi menggunakan document.execCommand('paste'). |
"clipboardWrite" |
Menunjukkan bahwa ekstensi atau aplikasi menggunakan document.execCommand('copy') atau document.execCommand('cut'). Izin ini diperlukan untuk aplikasi yang dihosting; izin ini direkomendasikan
untuk ekstensi dan aplikasi terpaket. |
"contentSettings" |
Memberi ekstensi Anda akses ke API chrome.contentSettings. |
"contextMenus" |
Memberi ekstensi Anda akses ke chrome.contextMenus API. |
"cookies" |
Memberi ekstensi Anda akses ke chrome.cookies API. |
"debugger" |
Memberi ekstensi Anda akses ke API chrome.debugger. |
"declarativeContent" |
Memberi ekstensi Anda akses ke chrome.declarativeContent API. |
"declarativeNetRequest" |
Memberi ekstensi Anda akses ke chrome.declarativeNetRequest API. |
"declarativeNetRequestFeedback" |
Memberikan akses ekstensi ke peristiwa dan metode dalam chrome.declarativeNetRequest API yang menampilkan informasi tentang aturan deklaratif yang cocok. |
"declarativeWebRequest" |
Memberi ekstensi Anda akses ke chrome.declarativeWebRequest API. |
"desktopCapture" |
Memberi ekstensi Anda akses ke chrome.desktopCapture API. |
"documentScan" |
Memberi ekstensi Anda akses ke chrome.documentScan API. |
"downloads" |
Memberi ekstensi Anda akses ke chrome.downloads API. |
"enterprise.deviceAttributes" |
Memberi ekstensi Anda akses ke chrome.enterprise.deviceAttributes API. |
"enterprise.hardwarePlatform" |
Memberi ekstensi Anda akses ke chrome.enterprise.hardwarePlatform API. |
"enterprise.networkingAttributes" |
Memberi ekstensi Anda akses ke chrome.enterprise.networkingAttributes API. |
"enterprise.platformKeys" |
Memberi ekstensi Anda akses ke chrome.enterprise.platformKeys API. |
"experimental" |
Wajib jika ekstensi atau aplikasi menggunakan chrome.experimental.* apa pun API. |
"fileBrowserHandler" |
Memberi ekstensi Anda akses ke chrome.fileBrowserHandler API. |
"fileSystemProvider" |
Memberi ekstensi Anda akses ke API chrome.fileSystemProvider. |
"fontSettings" |
Memberi ekstensi Anda akses ke API chrome.fontSettings. |
"gcm" |
Memberi ekstensi Anda akses ke API chrome.gcm. |
"geolocation" |
Mengizinkan ekstensi atau aplikasi untuk menggunakan geolocation API tanpa meminta izin kepada pengguna. |
"history" |
Memberi ekstensi Anda akses ke API chrome.history. |
"identity" |
Memberi ekstensi Anda akses ke chrome.identity API. |
"idle" |
Memberi ekstensi Anda akses ke chrome.idle API. |
"loginState" |
Memberi ekstensi Anda akses ke chrome.loginState API. |
"management" |
Memberi ekstensi Anda akses ke chrome.management API. |
"nativeMessaging" |
Memberi ekstensi Anda akses ke API pesan native. |
"notifications" |
Memberi ekstensi Anda akses ke chrome.notifications API. |
"pageCapture" |
Memberi ekstensi Anda akses ke chrome.pageCapture API. |
"platformKeys" |
Memberi ekstensi Anda akses ke chrome.platformKeys API. |
"power" |
Memberi ekstensi Anda akses ke API chrome.power. |
"printerProvider" |
Memberi ekstensi Anda akses ke API chrome.printerProvider. |
"printing" |
Memberi ekstensi Anda akses ke API chrome.printing. |
"printingMetrics" |
Memberi ekstensi Anda akses ke chrome.printingMetrics API. |
"privacy" |
Memberi ekstensi Anda akses ke chrome.privacy API. |
"processes" |
Memberi ekstensi Anda akses ke API chrome.processes. |
"proxy" |
Memberi ekstensi Anda akses ke API chrome.proxy. |
"scripting" |
Memberi ekstensi Anda akses ke API chrome.scripting. |
"search" |
Memberi ekstensi Anda akses ke API chrome.search. |
"sessions" |
Memberi ekstensi Anda akses ke API chrome.sessions. |
"signedInDevices" |
Memberi ekstensi Anda akses ke chrome.signedInDevices API. |
"storage" |
Memberi ekstensi Anda akses ke chrome.storage API. |
"system.cpu" |
Memberi ekstensi Anda akses ke API chrome.system.cpu. |
"system.display" |
Memberi ekstensi Anda akses ke API chrome.system.display. |
"system.memory" |
Memberi ekstensi Anda akses ke API chrome.system.memory. |
"system.storage" |
Memberi ekstensi Anda akses ke API chrome.system.storage. |
"tabCapture" |
Memberi ekstensi Anda akses ke chrome.tabCapture API. |
"tabGroups" |
Memberi ekstensi Anda akses ke chrome.tabGroups API. |
"tabs" |
Memberi ekstensi akses ke kolom istimewa untuk objek Tab yang digunakan oleh beberapa API,
termasuk chrome.tabs dan chrome.windows. Dalam banyak situasi, ekstensi Anda tidak perlu mendeklarasikan izin "tabs" untuk menggunakan API ini. |
"topSites" |
Memberi ekstensi Anda akses ke chrome.topSites API. |
"tts" |
Memberi ekstensi Anda akses ke API chrome.tts. |
"ttsEngine" |
Memberi ekstensi Anda akses ke chrome.ttsEngine API. |
"unlimitedStorage" |
Memberikan kuota tanpa batas untuk menyimpan data sisi klien, seperti database dan file penyimpanan lokal.
Tanpa izin ini, ekstensi atau aplikasi dibatasi hingga 5 MB penyimpanan lokal. Catatan: Izin ini hanya berlaku untuk Database Web SQL dan cache aplikasi
(lihat masalah 58985). Selain itu, metode ini saat ini tidak berfungsi dengan subdomain
karakter pengganti seperti
http://*.example.com. |
"vpnProvider" |
Memberi ekstensi Anda akses ke API chrome.vpnProvider. |
"wallpaper" |
Memberi ekstensi Anda akses ke API chrome.wallpaper. |
"webNavigation" |
Memberi ekstensi Anda akses ke chrome.webNavigation API. |
"webRequest" |
Memberi ekstensi Anda akses ke chrome.webRequest API. |
"webRequestBlocking" |
Diperlukan jika ekstensi menggunakan chrome.webRequest API dengan cara pemblokiran. |