chrome.privacy

refresh date: 2026-09-25 robots: noindex

תיאור

אפשר להשתמש ב-API של chrome.privacy כדי לשלוט בשימוש בתכונות ב-Chrome שיכולות להשפיע על פרטיות המשתמשים. ה-API הזה מסתמך על אב הטיפוס ChromeSetting של ה-API מסוג type כדי לקבל ולהגדיר את ההגדרות של Chrome.

הרשאות

privacy

מניפסט

כדי להשתמש ב-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() תצליח, אבל ההגדרה תוחלף באופן מיידי. זה עלול לבלבל, ולכן מומלץ להזהיר את המשתמשים כשההגדרות שהם בחרו לא מיושמות בפועל.

כלומר, צריך להשתמש ב-method‏ 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);
      }
    });
  }
});

אם אתם רוצים לדעת על שינויים בערך של הגדרה, הוסיפו מאזין לאירוע 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 ואילך

קטגוריות של נתוני מילוי אוטומטי.

טיפוסים בני מנייה (enum)

"contact_info"

"payments"

"identity_docs"

"נסיעות"

"all"

IPHandlingPolicy

‫Chrome מגרסה 48 ואילך

מדיניות הטיפול ב-IP של WebRTC.

טיפוסים בני מנייה (enum)

"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 כש"גלישה בטוחה" חוסמת דף, כמו התוכן של הדף החסום. ערך ההעדפה הזו הוא בוליאני, וברירת המחדל היא 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 שולח פינגים של ביקורת כשהוא מקבל בקשה מאתר (<a ping>). הערך של ההעדפה הזו הוא מסוג בוליאני, וערך ברירת המחדל הוא true.

  • protectedContentEnabled

    types.ChromeSetting<boolean>

    זמין רק ב-Windows וב-ChromeOS: אם ההגדרה מופעלת, Chrome מספק מזהה ייחודי לפלאגינים כדי להפעיל תוכן מוגן. הערך של ההעדפה הזו הוא מסוג בוליאני, וערך ברירת המחדל הוא true.

  • referrersEnabled

    types.ChromeSetting<boolean>

    אם המדיניות מופעלת, Chrome שולח כותרות referer עם הבקשות שלך. כן, השם של ההעדפה הזו לא תואם לכותרת עם שגיאת הכתיב. לא, אנחנו לא מתכוונים לשנות אותו. הערך של ההעדפה הזו הוא מסוג בוליאני, וערך ברירת המחדל הוא true.

  • thirdPartyCookiesAllowed

    types.ChromeSetting<boolean>

    אם המדיניות מושבתת, Chrome חוסם אתרים של צד שלישי מהגדרת קובצי Cookie. הערך של ההעדפה הזו הוא מסוג בוליאני, וערך ברירת המחדל הוא true. יכול להיות שתוספים לא יפעילו את ה-API הזה במצב פרטי, שבו קובצי Cookie של צד שלישי חסומים ואפשר להפעיל אותם רק ברמת האתר. אם תנסו להגדיר את ה-API הזה כ-true במצב פרטי, תופיע שגיאה.

    הערה: יכול להיות שאתרים ספציפיים עדיין יוכלו לגשת לקובצי Cookie של צד שלישי כשה-API הזה מחזיר את הערך false, אם יש להם פטור תקף או אם הם משתמשים ב-Storage Access API במקום זאת.

  • topicsEnabled

    types.ChromeSetting<boolean>

    ‫Chrome מגרסה 111 ואילך

    אם המדיניות מושבתת, Topics API מושבת. הערך של ההעדפה הזו הוא מסוג בוליאני, וערך ברירת המחדל הוא true. תוספים יכולים להשבית את ה-API הזה רק על ידי הגדרת הערך ל-false. אם תנסו להגדיר את ה-API הזה לערך true, תופיע הודעת שגיאה.