หากต้องการใช้ Chrome ส่วนใหญ่* API ส่วนขยายหรือแอปจะต้องประกาศเจตนาของส่วนขยายนั้นๆ ใน "สิทธิ์" ฟิลด์ ของไฟล์ Manifest สิทธิ์แต่ละรายการอาจเป็นรายการสตริงที่รู้จักรายการใดรายการหนึ่ง (เช่น "ตำแหน่งทางภูมิศาสตร์") หรือรูปแบบการจับคู่ที่ให้สิทธิ์เข้าถึงโฮสต์อย่างน้อย 1 รายการ ความช่วยเหลือเกี่ยวกับสิทธิ์สำหรับ จำกัดความเสียหายหากส่วนขยายหรือแอปถูกมัลแวร์โจมตี สิทธิ์บางรายการจะปรากฏขึ้นด้วย ให้ผู้ใช้ก่อนการติดตั้ง ตามรายละเอียดในคำเตือนเกี่ยวกับสิทธิ์
หาก API กำหนดให้คุณประกาศสิทธิ์ในไฟล์ Manifest เอกสารประกอบของ API นั้นบอกวิธีที่ ให้ทำเช่นนั้นได้ ตัวอย่างเช่น หน้าพื้นที่เก็บข้อมูลจะแสดงวิธีประกาศ "พื้นที่เก็บข้อมูล" สิทธิ์
ต่อไปนี้คือตัวอย่างส่วนสิทธิ์ของไฟล์ Manifest
"permissions": [
"tabs",
"bookmarks",
"http://www.blogger.com/",
"http://*.google.com/",
"unlimitedStorage"
],
ตารางต่อไปนี้แสดงสิทธิ์ที่ใช้ได้ในปัจจุบัน
| สิทธิ์ | คำอธิบาย |
|---|---|
"activeTab" |
คำขอที่ส่วนขยายได้รับสิทธิ์ตาม activeTab |
"alarms" |
ให้สิทธิ์เข้าถึง API chrome.alarms ของส่วนขยาย |
"background" |
ทำให้ Chrome เริ่มทำงานเร็วและปิดตัวไปช้าเพื่อให้แอปและส่วนขยายมี ชีวิต เมื่อแอปที่โฮสต์ แอปแพ็กเกจ หรือส่วนขยายใดๆ ที่ติดตั้งมี "เบื้องหลัง" Chrome จะเรียกใช้ (มองไม่เห็น) ทันทีที่ผู้ใช้เข้าสู่ระบบในคอมพิวเตอร์ ก่อนที่ผู้ใช้จะเปิด Chrome "พื้นหลัง" ยังทำให้ Chrome ทำงานต่อไปได้ (แม้จะปิดหน้าต่างสุดท้ายแล้ว) จนกว่าผู้ใช้จะ ปิด Chrome หมายเหตุ: แอปและส่วนขยายที่ปิดใช้จะถือว่าไม่เป็นเช่นนั้น
ติดตั้งไว้แล้ว
ปกติแล้วคุณจะใช้ "พื้นหลัง" สิทธิ์ที่มีหน้าพื้นหลัง หน้ากิจกรรม หรือ (สำหรับแอปที่โฮสต์) หน้าต่างเบื้องหลัง |
"bookmarks" |
ให้สิทธิ์เข้าถึง chrome.bookmarks API แก่ส่วนขยาย |
"browsingData" |
ให้สิทธิ์เข้าถึง chrome.browsingData API แก่ส่วนขยาย |
"certificateProvider" |
ให้สิทธิ์เข้าถึง API chrome.certificateProvider แก่ส่วนขยายของคุณ |
"clipboardRead" |
ต้องระบุหากส่วนขยายหรือแอปใช้ document.execCommand('paste') |
"clipboardWrite" |
ระบุว่าส่วนขยายหรือแอปใช้ document.execCommand('copy') หรือ
document.execCommand('cut') สิทธิ์นี้จำเป็นสำหรับแอปที่โฮสต์ แนะนำเลย
สำหรับส่วนขยายและแอปแพ็กเกจ |
"contentSettings" |
ให้สิทธิ์เข้าถึง chrome.contentSettings API แก่ส่วนขยาย |
"contextMenus" |
ให้สิทธิ์เข้าถึง chrome.contextMenus API แก่ส่วนขยาย |
"cookies" |
ให้สิทธิ์เข้าถึง chrome.cookies API แก่ส่วนขยาย |
"debugger" |
ให้สิทธิ์เข้าถึง chrome.debugger API แก่ส่วนขยาย |
"declarativeContent" |
ให้สิทธิ์เข้าถึง chrome.declarativeContent API แก่ส่วนขยาย |
"declarativeNetRequest" |
ให้สิทธิ์เข้าถึง chrome.declarativeNetRequest API สำหรับส่วนขยาย |
"declarativeNetRequestFeedback" |
ให้สิทธิ์ส่วนขยายในการเข้าถึงเหตุการณ์และเมธอดภายใน chrome.declarativeNetRequest API ซึ่งแสดงผลข้อมูลการประกาศ ตรงกัน |
"declarativeWebRequest" |
ให้สิทธิ์เข้าถึง chrome.declarativeWebRequest API ของส่วนขยาย |
"desktopCapture" |
ให้สิทธิ์เข้าถึง chrome.desktopCapture API แก่ส่วนขยาย |
"documentScan" |
ให้สิทธิ์เข้าถึง chrome.documentScan API แก่ส่วนขยาย |
"downloads" |
ให้สิทธิ์เข้าถึง API chrome.downloads แก่ส่วนขยาย |
"enterprise.deviceAttributes" |
ให้สิทธิ์เข้าถึง chrome.enterprise.deviceAttributes API แก่ส่วนขยาย |
"enterprise.hardwarePlatform" |
ให้สิทธิ์เข้าถึง chrome.enterprise.hardwarePlatform API แก่ส่วนขยาย |
"enterprise.networkingAttributes" |
ให้สิทธิ์เข้าถึง chrome.enterprise.networkingAttributes API แก่ส่วนขยายของคุณ |
"enterprise.platformKeys" |
ให้สิทธิ์เข้าถึง chrome.enterprise.platformKeys API แก่ส่วนขยายของคุณ |
"experimental" |
ต้องระบุหากส่วนขยายหรือแอปใช้ chrome.experimental* API |
"fileBrowserHandler" |
ให้สิทธิ์เข้าถึง chrome.fileBrowserHandler API แก่ส่วนขยาย |
"fileSystemProvider" |
ให้สิทธิ์เข้าถึง chrome.fileSystemProvider API แก่ส่วนขยายของคุณ |
"fontSettings" |
ให้สิทธิ์เข้าถึง chrome.fontSettings API แก่ส่วนขยาย |
"gcm" |
ให้สิทธิ์เข้าถึง API chrome.gcm แก่ส่วนขยาย |
"geolocation" |
อนุญาตให้ส่วนขยายหรือแอปใช้ API ตำแหน่งทางภูมิศาสตร์โดยไม่ต้องแจ้งผู้ใช้ให้ระบุ สิทธิ์ |
"history" |
ให้สิทธิ์เข้าถึง chrome.history API แก่ส่วนขยาย |
"identity" |
ให้สิทธิ์เข้าถึง chrome.identity API ให้กับส่วนขยาย |
"idle" |
ให้สิทธิ์เข้าถึง API chrome.idle แก่ส่วนขยาย |
"loginState" |
ให้สิทธิ์เข้าถึง chrome.loginState API แก่ส่วนขยาย |
"management" |
ให้สิทธิ์เข้าถึง chrome.management API แก่ส่วนขยาย |
"nativeMessaging" |
ให้สิทธิ์เข้าถึง เนทีฟ Messaging API ให้กับส่วนขยาย |
"notifications" |
ให้ส่วนขยายเข้าถึง chrome.notifications API |
"pageCapture" |
ให้สิทธิ์เข้าถึง chrome.pageCapture API แก่ส่วนขยาย |
"platformKeys" |
ให้สิทธิ์เข้าถึง chrome.platformKeys API แก่ส่วนขยาย |
"power" |
ให้สิทธิ์เข้าถึง API chrome.power แก่ส่วนขยาย |
"printerProvider" |
ให้สิทธิ์เข้าถึง chrome.printerProvider API แก่ส่วนขยาย |
"printing" |
ให้สิทธิ์เข้าถึง chrome.printing API แก่ส่วนขยาย |
"printingMetrics" |
ให้สิทธิ์เข้าถึง API chrome.printingMetrics แก่ส่วนขยาย |
"privacy" |
ให้สิทธิ์เข้าถึง chrome.privacy API แก่ส่วนขยาย |
"processes" |
ให้สิทธิ์เข้าถึง API chrome.processes แก่ส่วนขยาย |
"proxy" |
ให้สิทธิ์เข้าถึง chrome.proxy API แก่ส่วนขยาย |
"scripting" |
ให้สิทธิ์เข้าถึง chrome.scripting API แก่ส่วนขยาย |
"search" |
ให้สิทธิ์เข้าถึง chrome.search API แก่ส่วนขยาย |
"sessions" |
ให้สิทธิ์เข้าถึง chrome.sessions API แก่ส่วนขยาย |
"signedInDevices" |
ให้สิทธิ์เข้าถึง chrome.signedInDevices API แก่ส่วนขยาย |
"storage" |
ให้สิทธิ์เข้าถึง API chrome.storage แก่ส่วนขยาย |
"system.cpu" |
ให้สิทธิ์เข้าถึง API chrome.system.cpu แก่ส่วนขยาย |
"system.display" |
ให้สิทธิ์เข้าถึง API chrome.system.display แก่ส่วนขยาย |
"system.memory" |
ให้สิทธิ์เข้าถึง API chrome.system.memory แก่ส่วนขยาย |
"system.storage" |
ให้สิทธิ์เข้าถึง API chrome.system.storage แก่ส่วนขยาย |
"tabCapture" |
ให้สิทธิ์เข้าถึง chrome.tabCapture API แก่ส่วนขยาย |
"tabGroups" |
ให้สิทธิ์เข้าถึง chrome.tabGroups API แก่ส่วนขยาย |
"tabs" |
ให้สิทธิ์เข้าถึงช่องที่มีสิทธิ์ของออบเจ็กต์ Tab ที่ API หลายรายการใช้แก่ส่วนขยาย
รวมถึง chrome.tabs และ chrome.windows ใน
ในหลายกรณี ส่วนขยายของคุณไม่จำเป็นต้องประกาศสิทธิ์ "tabs" เพื่อใช้ประโยชน์จาก
API เหล่านี้ |
"topSites" |
ให้สิทธิ์เข้าถึง chrome.topSites API แก่ส่วนขยาย |
"tts" |
ให้สิทธิ์เข้าถึง API chrome.tts แก่ส่วนขยาย |
"ttsEngine" |
ให้สิทธิ์เข้าถึง chrome.ttsEngine API แก่ส่วนขยาย |
"unlimitedStorage" |
ให้โควต้าที่ไม่จำกัดสำหรับการจัดเก็บข้อมูลฝั่งไคลเอ็นต์ เช่น ฐานข้อมูลและไฟล์พื้นที่เก็บข้อมูลในเครื่อง
หากไม่มีสิทธิ์นี้ ส่วนขยายหรือแอปจะมีพื้นที่เก็บข้อมูลในเครื่องได้ไม่เกิน 5 MB หมายเหตุ: สิทธิ์นี้ใช้กับฐานข้อมูล Web SQL และแคชของแอปพลิเคชันเท่านั้น
(ดูฉบับ 58985) รวมถึงใช้งานกับไวลด์การ์ดไม่ได้ในตอนนี้
โดเมนย่อย เช่น
http://*.example.com |
"vpnProvider" |
ให้สิทธิ์เข้าถึง chrome.vpnProvider API แก่ส่วนขยาย |
"wallpaper" |
ให้สิทธิ์เข้าถึง API chrome.wallpaper ของส่วนขยาย |
"webNavigation" |
ให้สิทธิ์เข้าถึง chrome.webNavigation API แก่ส่วนขยาย |
"webRequest" |
ให้สิทธิ์เข้าถึง chrome.webRequest API แก่ส่วนขยาย |
"webRequestBlocking" |
ต้องระบุหากส่วนขยายใช้ chrome.webRequest API ในการบล็อก |