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 יוגדר כ-"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);
      }
    });
  }
});

אם רוצים לשנות ערך של הגדרה, צריך להוסיף האזנה לאירוע 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 הזה, צריך להתקין את הדוגמה של ה-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 שולח את הכותרת 'אל תעקוב' (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.

  • relatedWebsiteSetsEnabled

    types.ChromeSetting<boolean>

    Chrome 121 ומעלה

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

  • thirdPartyCookiesAllowed

    types.ChromeSetting<boolean>

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

  • topicsEnabled

    types.ChromeSetting<boolean>

    Chrome 111 ומעלה

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