chrome.privacy

תיאור

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

הרשאות

privacy

חובה להצהיר על "פרטיות" במניפסט של התוסף לשימוש ב-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 יוגדר כ-"control_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);
      }
    });
  }
});

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

Chrome 48 ואילך

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

Enum

"ברירת מחדל"

"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.

  • 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&lt;boolean&gt;

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

  • referrersEnabled

    types.ChromeSetting&lt;boolean&gt;

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

  • relatedWebsiteSetsEnabled

    types.ChromeSetting&lt;boolean&gt;

    Chrome 121 ואילך

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

  • thirdPartyCookiesAllowed

    types.ChromeSetting&lt;boolean&gt;

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

  • topicsEnabled

    types.ChromeSetting&lt;boolean&gt;

    Chrome 111 ואילך

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