คำอธิบาย
ใช้ chrome.privacy
API เพื่อควบคุมการใช้งานฟีเจอร์ใน Chrome ที่อาจส่งผลต่อความเป็นส่วนตัวของผู้ใช้ API นี้อาศัยต้นแบบ ChromeSetting ของ Type API ในการรับและตั้งค่ากำหนดค่าของ Chrome
สิทธิ์
privacy
คุณต้องประกาศสิทธิ์ "ความเป็นส่วนตัว" ในไฟล์ Manifest ของส่วนขยายเพื่อใช้ API เช่น
{
"name": "My extension",
...
"permissions": [
"privacy"
],
...
}
แนวคิดและการใช้งาน
การอ่านค่าปัจจุบันของการตั้งค่า Chrome เป็นเรื่องง่าย ก่อนอื่นคุณต้องค้นหาพร็อพเพอร์ตี้ที่สนใจ จากนั้นเรียกใช้ get()
ในออบเจ็กต์นั้นเพื่อดึงค่าปัจจุบันและระดับการควบคุมของส่วนขยาย เช่น หากต้องการตรวจสอบว่าได้เปิดใช้ฟีเจอร์ป้อนข้อความอัตโนมัติของบัตรเครดิตใน Chrome
หรือไม่ คุณจะต้องเขียนดังนี้
chrome.privacy.services.autofillCreditCardEnabled.get({}, function(details) {
if (details.value) {
console.log('Autofill is on!');
} else {
console.log('Autofill is off!');
}
});
การเปลี่ยนค่าของการตั้งค่าจะซับซ้อนกว่าเล็กน้อย เนื่องจากคุณต้องยืนยันก่อน
ว่าส่วนขยายควบคุมการตั้งค่าได้ ผู้ใช้จะไม่เห็นการเปลี่ยนแปลงใดๆ ในการตั้งค่าหากส่วนขยายของคุณ
สลับการตั้งค่าที่ล็อกไว้เป็นค่าใดค่าหนึ่งโดยนโยบายขององค์กร
(levelOfControl
จะตั้งค่าเป็น "not_controllable") หรือหากส่วนขยายอื่นควบคุม
ค่าอยู่ (levelOfControl
จะตั้งค่าเป็น "controlled_by_other_extensions") การเรียกใช้ set()
จะ
สำเร็จ แต่ระบบจะลบล้างการตั้งค่าทันที เนื่องจากอาจทำให้เกิดความสับสน จึงขอแนะนำ
ให้เตือนผู้ใช้เมื่อการตั้งค่าที่เลือกไว้ไม่มีผลในทางปฏิบัติ
ซึ่งหมายความว่าคุณควรใช้วิธี get()
เพื่อกำหนดระดับการเข้าถึง แล้วเรียกใช้ set()
เฉพาะในกรณีที่ส่วนขยายควบคุมการตั้งค่าได้ (ในความเป็นจริง หากส่วนขยายควบคุมการตั้งค่าไม่ได้ คุณควรปิดใช้ฟีเจอร์นี้ด้วยภาพเพื่อลดความสับสนของผู้ใช้)
chrome.privacy.services.autofillCreditCardEnabled.get({}, function(details) {
if (details.levelOfControl === 'controllable_by_this_extension') {
chrome.privacy.services.autofillCreditCardEnabled.set({ value: true }, function() {
if (chrome.runtime.lastError === undefined) {
console.log("Hooray, it worked!");
} else {
console.log("Sadness!", chrome.runtime.lastError);
}
});
}
});
หากสนใจการเปลี่ยนแปลงค่าของการตั้งค่า ให้เพิ่ม Listener ลงในเหตุการณ์ onChange
การดำเนินการนี้จะช่วยให้คุณเตือนผู้ใช้ได้หากส่วนขยายที่ติดตั้งล่าสุดควบคุมการตั้งค่า หรือหากนโยบายระดับองค์กรลบล้างการควบคุมของคุณ หากต้องการฟังการเปลี่ยนแปลงสถานะการป้อนข้อมูลอัตโนมัติของบัตรเครดิต เช่น โค้ดต่อไปนี้ก็เพียงพอ
chrome.privacy.services.autofillCreditCardEnabled.onChange.addListener(
function (details) {
// The new value is stored in `details.value`, the new level of control
// in `details.levelOfControl`, and `details.incognitoSpecific` will be
// `true` if the value is specific to Incognito mode.
}
);
ตัวอย่าง
หากต้องการลองใช้ API นี้ ให้ติดตั้งตัวอย่าง Privacy API จากที่เก็บ chrome-extension-samples
ประเภท
IPHandlingPolicy
นโยบายการจัดการ IP ของ WebRTC
ค่าแจกแจง
"default"
"default_public_and_private_interfaces"
"default_public_interface_only"
"disable_non_proxied_udp"
พร็อพเพอร์ตี้
network
การตั้งค่าที่มีผลต่อการจัดการการเชื่อมต่อเครือข่ายของ Chrome โดยทั่วไป
ประเภท
ออบเจ็กต์
พร็อพเพอร์ตี้
-
networkPredictionEnabled
types.ChromeSetting<boolean>
หากเปิดใช้ Chrome จะพยายามเร่งประสบการณ์การท่องเว็บของคุณโดยการแก้ไขรายการ DNS ล่วงหน้า และเปิดการเชื่อมต่อ TCP และ SSL กับเซิร์ฟเวอร์ล่วงหน้า ค่ากำหนดนี้จะส่งผลต่อการดำเนินการที่บริการคาดคะเนภายในของ Chrome เท่านั้น โดยจะไม่ส่งผลต่อการดึงข้อมูลล่วงหน้าหรือการเชื่อมต่อล่วงหน้าที่เริ่มต้นโดยหน้าเว็บ ค่าของค่ากำหนดนี้เป็นบูลีน โดยค่าเริ่มต้นจะเป็น
true
-
webRTCIPHandlingPolicyChrome 48 ขึ้นไป
อนุญาตให้ผู้ใช้ระบุการแลกเปลี่ยนประสิทธิภาพ/ความเป็นส่วนตัวของสื่อ ซึ่งจะส่งผลต่อวิธีกำหนดเส้นทางการรับส่งข้อมูล WebRTC และปริมาณข้อมูลที่อยู่ภายในที่เปิดเผย ค่าของค่ากำหนดนี้เป็นประเภท IPHandlingPolicy ซึ่งมีค่าเริ่มต้นเป็น
default
services
การตั้งค่าที่เปิดหรือปิดใช้ฟีเจอร์ที่ต้องใช้บริการเครือข่ายของบุคคลที่สามซึ่งให้บริการโดย Google และผู้ให้บริการค้นหาเริ่มต้น
ประเภท
ออบเจ็กต์
พร็อพเพอร์ตี้
-
alternateErrorPagesEnabled
types.ChromeSetting<boolean>
หากเปิดใช้ Chrome จะใช้บริการเว็บเพื่อช่วยแก้ไขข้อผิดพลาดในการนำทาง ค่าของค่ากำหนดนี้เป็นบูลีน โดยค่าเริ่มต้นจะเป็น
true
-
autofillAddressEnabled
types.ChromeSetting<boolean>
Chrome 70 ขึ้นไปหากเปิดใช้ Chrome จะเสนอให้ป้อนที่อยู่และข้อมูลแบบฟอร์มอื่นๆ โดยอัตโนมัติ ค่าของค่ากำหนดนี้เป็นบูลีน โดยค่าเริ่มต้นจะเป็น
true
-
autofillCreditCardEnabled
types.ChromeSetting<boolean>
Chrome 70 ขึ้นไปหากเปิดใช้ Chrome จะเสนอให้กรอกแบบฟอร์มบัตรเครดิตโดยอัตโนมัติ ค่าของค่ากำหนดนี้เป็นบูลีน โดยค่าเริ่มต้นจะเป็น
true
-
autofillEnabled
types.ChromeSetting<boolean>
เลิกใช้งานตั้งแต่ Chrome 70โปรดใช้ privacy.services.autofillAddressEnabled และ privacy.services.autofillCreditCardEnabled การดำเนินการนี้ยังคงมีไว้เพื่อความเข้ากันได้แบบย้อนหลังในรุ่นนี้ และจะถูกนำออกในอนาคต
หากเปิดใช้ Chrome จะเสนอให้กรอกแบบฟอร์มโดยอัตโนมัติ ค่าของค่ากำหนดนี้เป็นบูลีน โดยค่าเริ่มต้นจะเป็น
true
-
passwordSavingEnabled
types.ChromeSetting<boolean>
หากเปิดใช้ เครื่องมือจัดการรหัสผ่านจะถามว่าคุณต้องการบันทึกรหัสผ่านหรือไม่ ค่าของค่ากำหนดนี้เป็นบูลีน โดยค่าเริ่มต้นจะเป็น
true
-
safeBrowsingEnabled
types.ChromeSetting<boolean>
หากเปิดใช้ Chrome จะพยายามอย่างเต็มที่เพื่อปกป้องคุณจากฟิชชิงและมัลแวร์ ค่าของค่ากำหนดนี้เป็นบูลีน โดยค่าเริ่มต้นจะเป็น
true
-
safeBrowsingExtendedReportingEnabled
types.ChromeSetting<boolean>
หากเปิดใช้ Chrome จะส่งข้อมูลเพิ่มเติมไปยัง Google เมื่อ Google Safe Browsing บล็อกหน้าเว็บ เช่น เนื้อหาของหน้าเว็บที่ถูกบล็อก ค่าของค่ากำหนดนี้เป็นบูลีน โดยค่าเริ่มต้นจะเป็น
false
-
searchSuggestEnabled
types.ChromeSetting<boolean>
หากเปิดใช้ Chrome จะส่งข้อความที่คุณพิมพ์ลงในแถบอเนกประสงค์ไปยังเครื่องมือค้นหาเริ่มต้น ซึ่งจะคาดคะเนเว็บไซต์และการค้นหาที่น่าจะเป็นข้อความที่คุณพิมพ์จนถึงตอนนี้ ค่าของค่ากำหนดนี้เป็นบูลีน โดยค่าเริ่มต้นจะเป็น
true
-
spellingServiceEnabled
types.ChromeSetting<boolean>
หากเปิดใช้ Chrome จะใช้บริการเว็บเพื่อช่วยแก้ไขข้อผิดพลาดของการสะกดคำ ค่าของค่ากำหนดนี้เป็นบูลีน โดยค่าเริ่มต้นจะเป็น
false
-
translationServiceEnabled
types.ChromeSetting<boolean>
หากเปิดใช้ Chrome จะเสนอการแปลหน้าเว็บที่ไม่ได้อยู่ในภาษาที่คุณอ่านได้ ค่าของค่ากำหนดนี้เป็นบูลีน โดยค่าเริ่มต้นจะเป็น
true
websites
การตั้งค่าที่กำหนดข้อมูลที่ Chrome จะแสดงต่อเว็บไซต์
ประเภท
ออบเจ็กต์
พร็อพเพอร์ตี้
-
adMeasurementEnabled
types.ChromeSetting<boolean>
Chrome 111 ขึ้นไปหากปิดใช้ Attribution Reporting API และ Private Aggregation API จะถูกปิดใช้งาน ค่าของค่ากำหนดนี้เป็นประเภทบูลีน และค่าเริ่มต้นคือ
true
ส่วนขยายจะปิดใช้ API เหล่านี้ได้โดยตั้งค่าเป็นfalse
เท่านั้น หากคุณพยายามตั้งค่า API เหล่านี้เป็นtrue
ระบบจะแสดงข้อผิดพลาด -
doNotTrackEnabled
types.ChromeSetting<boolean>
Chrome 65 ขึ้นไปหากเปิดใช้ Chrome จะส่งส่วนหัว "ห้ามติดตาม" (
DNT: 1
) พร้อมกับคำขอของคุณ ค่าของค่ากำหนดนี้เป็นประเภทบูลีน และค่าเริ่มต้นคือfalse
-
fledgeEnabled
types.ChromeSetting<boolean>
Chrome 111 ขึ้นไปหากปิดใช้ ระบบจะปิดใช้งาน Fledge API ค่าของค่ากำหนดนี้เป็นประเภทบูลีน และค่าเริ่มต้นคือ
true
ส่วนขยายจะปิดใช้ API นี้ได้โดยการตั้งค่าเป็นfalse
เท่านั้น หากคุณพยายามตั้งค่า API นี้เป็นtrue
ระบบจะแสดงข้อผิดพลาด -
hyperlinkAuditingEnabled
types.ChromeSetting<boolean>
หากเปิดใช้ Chrome จะส่งการ Ping การตรวจสอบเมื่อเว็บไซต์ขอ (
<a ping>
) ค่าของค่ากำหนดนี้เป็นประเภทบูลีน และค่าเริ่มต้นคือtrue
-
protectedContentEnabled
types.ChromeSetting<boolean>
ใช้ได้ใน Windows และ ChromeOS เท่านั้น: หากเปิดใช้ Chrome จะให้รหัสที่ไม่ซ้ำแก่ปลั๊กอินเพื่อเรียกใช้เนื้อหาที่ได้รับการปกป้อง ค่าของค่ากำหนดนี้เป็นประเภทบูลีน และค่าเริ่มต้นคือ
true
-
referrersEnabled
types.ChromeSetting<boolean>
หากเปิดใช้ Chrome จะส่งส่วนหัว
referer
พร้อมกับคำขอของคุณ ใช่ ชื่อของค่ากำหนดนี้ไม่ตรงกับส่วนหัวที่สะกดผิด ไม่ เราจะไม่เปลี่ยนแปลง ค่าของค่ากำหนดนี้เป็นประเภทบูลีน และค่าเริ่มต้นคือtrue
-
types.ChromeSetting<boolean>
Chrome 121 ขึ้นไปหากปิดใช้ ระบบจะปิดใช้งานชุดเว็บไซต์ที่เกี่ยวข้อง ค่าของค่ากำหนดนี้เป็นประเภทบูลีน และค่าเริ่มต้นคือ
true
ส่วนขยายจะปิดใช้ API นี้ได้โดยการตั้งค่าเป็นfalse
เท่านั้น หากคุณพยายามตั้งค่า API นี้เป็นtrue
ระบบจะแสดงข้อผิดพลาด -
thirdPartyCookiesAllowed
types.ChromeSetting<boolean>
หากปิดใช้ Chrome จะบล็อกไม่ให้เว็บไซต์ของบุคคลที่สามตั้งค่าคุกกี้ ค่าของค่ากำหนดนี้เป็นประเภทบูลีน และค่าเริ่มต้นคือ
true
ส่วนขยายอาจไม่เปิดใช้ API นี้ในโหมดไม่ระบุตัวตน ซึ่งคุกกี้ของบุคคลที่สามจะถูกบล็อกและอนุญาตเฉพาะในระดับเว็บไซต์เท่านั้น หากคุณพยายามตั้งค่า API นี้เป็น "จริง" ในโหมดไม่ระบุตัวตน ระบบจะแสดงข้อผิดพลาดหมายเหตุ: เว็บไซต์แต่ละแห่งอาจยังคงเข้าถึงคุกกี้ของบุคคลที่สามได้เมื่อ API นี้แสดงผล
false
หากเว็บไซต์มีข้อยกเว้นที่ถูกต้องหรือใช้ Storage Access API แทน -
topicsEnabled
types.ChromeSetting<boolean>
Chrome 111 ขึ้นไปหากปิดใช้ ระบบจะปิดใช้งาน Topics API ค่าของค่ากำหนดนี้เป็นประเภทบูลีน และค่าเริ่มต้นคือ
true
ส่วนขยายจะปิดใช้ API นี้ได้โดยการตั้งค่าเป็นfalse
เท่านั้น หากคุณพยายามตั้งค่า API นี้เป็นtrue
ระบบจะแสดงข้อผิดพลาด