chrome.privacy

refresh date: 2026-09-25 robots: noindex

คำอธิบาย

ใช้ chrome.privacy API เพื่อควบคุมการใช้งานฟีเจอร์ใน Chrome ที่อาจส่งผลต่อความเป็นส่วนตัวของผู้ใช้ API นี้อาศัยต้นแบบ ChromeSetting ของ API ประเภทเพื่อรับและตั้งค่าการกำหนดค่าของ Chrome

สิทธิ์

privacy

สิทธิ์นี้จะทริกเกอร์คำเตือน

ไฟล์ Manifest

คุณต้องประกาศสิทธิ์ "ความเป็นส่วนตัว" ใน manifest ของส่วนขยายเพื่อใช้ API เช่น

{
  "name": "My extension",
  ...
  "permissions": [
    "privacy"
  ],
  ...
}

การใช้งาน

การอ่านค่าปัจจุบันของการตั้งค่า Chrome นั้นทำได้ง่ายๆ ก่อนอื่นคุณจะต้องค้นหาพร็อพเพอร์ตี้ที่สนใจ จากนั้นจึงเรียก get() ในออบเจ็กต์นั้นเพื่อดึงค่าปัจจุบันและระดับการควบคุมของส่วนขยาย เช่น หากต้องการตรวจสอบว่าฟีเจอร์ป้อนข้อความอัตโนมัติของ Chrome เปิดใช้อยู่หรือไม่ ให้เขียนดังนี้

chrome.privacy.services.autofillEnabled.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() จะสำเร็จ แต่การตั้งค่าจะถูกลบล้างทันที เนื่องจากอาจทำให้เกิดความสับสน เราขอแนะนำให้เตือนผู้ใช้เมื่อการตั้งค่าที่เลือกไม่มีผลในทางปฏิบัติ

หมายเหตุ: ดูรายละเอียดทั้งหมดเกี่ยวกับความสามารถของส่วนขยายในการควบคุม ChromeSetting ได้ในส่วน chrome.types.ChromeSetting

ซึ่งหมายความว่าคุณควรใช้เมธอด get() เพื่อกำหนดระดับการเข้าถึง แล้วเรียกใช้ set() เฉพาะในกรณีที่ส่วนขยายสามารถควบคุมการตั้งค่าได้ (อันที่จริงแล้ว หากส่วนขยายควบคุมการตั้งค่าไม่ได้ คุณควรปิดใช้ฟังก์ชันการทำงานดังกล่าวเพื่อลดความสับสนของผู้ใช้)

chrome.privacy.services.autofillEnabled.get({}, function(details) {
  if (details.levelOfControl === 'controllable_by_this_extension') {
    chrome.privacy.services.autofillEnabled.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.autofillEnabled.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 นี้ ให้ติดตั้งตัวอย่าง API ความเป็นส่วนตัวจากที่เก็บ chrome-extension-samples

ประเภท

AutofillBlockedType

Chrome 151 ขึ้นไป

หมวดหมู่ของข้อมูลการป้อนข้อความอัตโนมัติ

ค่าแจกแจง

"contact_info"

"payments"

"identity_docs"

"travel"

"all"

IPHandlingPolicy

Chrome 48 ขึ้นไป

นโยบายการจัดการ 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 กับเซิร์ฟเวอร์ล่วงหน้า และโหลดหน้าเว็บล่วงหน้า การปิดใช้ค่ากำหนดนี้จะลบล้างความสามารถของเจ้าของเว็บไซต์ในการโหลดเนื้อหาแบบคาดเดา (เช่น การดึงข้อมูลล่วงหน้าหรือการแสดงผลล่วงหน้าผ่าน Speculation Rules API) แต่จะไม่ส่งผลต่อการเชื่อมต่อล่วงหน้าที่เริ่มต้นโดยหน้าเว็บหรือการดึงข้อมูล DNS ล่วงหน้า ค่าของค่ากำหนดนี้เป็นบูลีน โดยมีค่าเริ่มต้นเป็น true

• webRTCIPHandlingPolicy

  types.ChromeSetting<IPHandlingPolicy>

  Chrome 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 เมื่อ SafeBrowsing บล็อกหน้าเว็บ เช่น เนื้อหาของหน้าเว็บที่ถูกบล็อก ค่าของค่ากำหนดนี้เป็นบูลีน โดยมีค่าเริ่มต้นเป็น 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 จะส่งส่วนหัว "Do Not Track" (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

• 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 ระบบจะแสดงข้อผิดพลาด