תקופת ניסיון להוצאה משימוש של התכונה 'הפחתת מידע בסוכן משתמש'

תקופת הניסיון להוצאה משימוש של סוכן המשתמש אפשרה לאתרים להמשיך לקבל את המחרוזת המלאה של סוכן המשתמש אחרי הפחתת המחרוזת של UA. תקופת הניסיון הסתיימה ב-23 בספטמבר 2023.

החל מגרסה 101 של Chrome, המידע הזמין במחרוזת User-Agent (UA) יצטמצם בגישה הדרגתית. אתרים שעדיין לא נשאר להם זמן להפסיק את השימוש במחרוזת המצומצמת של סוכן המשתמש ולעבור ישירות ל-User-Agent Client Hints יכולים להשתתף בתקופת ניסיון להוצאה משימוש כדי להמשיך לקבל את המחרוזת המלאה של סוכן המשתמש.

הרישום לתקופת הניסיון להוצאה משימוש יתחיל בגרסת הבטא של Chrome 100. היא תאפשר לאתרים לקבל את המחרוזת המלאה של סוכן המשתמש לפני גרסת Chrome 101, שבה המחרוזת של הגרסה המשנית תקטן. אם ברצונך לבדוק את גרסת המקור לניסיון של Chrome 100 לפני ההשקה לערוץ היציב, עליך להירשם ולבדוק לפני תאריך ההשקה של Chrome 100 (התאריך מתוכנן כרגע ל-31 במרץ 2022).

בהמשך יש סקירה כללית של תקופת הניסיון להוצאה משימוש ולמה אפשר לצפות לה. אם נתקלתם בבעיות במהלך תקופת הניסיון הזו במשוב או במשוב שאתם רוצים לשתף, תוכלו לעדכן אותנו במאגר של UA לצמצום ב-GitHub.

מה המשמעות מבחינת מפתחי אתרים?

כשנרשמים לתקופת הניסיון להוצאה משימוש, אתרים ימשיכו לקבל את מחרוזת UA המלאה ב-navigator.userAgent וערכים לא מופחתים בנמעני ה-navigator.platform ו-navigator.appVersion הקשורים ל-JavaScript:

  • כותרת בקשת ה-HTTP User-Agent
  • מקבל JavaScript של navigator.userAgent
  • מקבל JavaScript של navigator.platform
  • מקבל JavaScript של navigator.appVersion

עדיין צריך לבדוק באתרים את השימוש בכותרת של סוכן המשתמש ובממשקי ה-API הקשורים, ולהתכונן לעבור ל-User-Agent Client Hints לפני שתקופת הניסיון להוצאה משימוש תסתיים. המטרה היא לסיים את תקופת הניסיון להוצאה משימוש ברגע שההשקה של הפחתת ההפחתה בסוכן המשתמש תסתיים.

איך אפשר להשתתף בגרסת הניסיון של ההוצאה משימוש של סוכן המשתמש?

הרשמה לתקופת הניסיון

כדי להירשם לגרסת המקור לניסיון ולקבל אסימון עבור הדומיינים שלכם, יש להיכנס לדף גרסת הניסיון להוצאה משימוש של סוכן המשתמש. אם הרישום שלך מתבצע על ידי צד שלישי, יש לסמן את האפשרות 'התאמה של צד שלישי'.

הגדרה

אחרי שתירשמו לתקופת הניסיון, עדכנו את כותרות התגובה של HTTP כך:

  1. מוסיפים את Origin-Trial: <ORIGIN TRIAL TOKEN> לכותרת התגובה של ה-HTTP. <ORIGIN TRIAL TOKEN> מכיל את האסימון שקיבלת כשנרשמת לגרסת המקור לניסיון.
  2. מוסיפים את Accept-CH: Sec-CH-UA-Full לכותרת התגובה של ה-HTTP. הגדרה של Accept-CH תגרום לשליחה של המחרוזת המלאה של סוכן המשתמש רק בבקשות הבאות למקור.
  3. אם המחרוזת המלאה של סוכן המשתמש היא קריטית בבקשה הראשונה, צריך להוסיף את Critical-CH: Sec-CH-UA-Full לכותרת התגובה של ה-HTTP, בנוסף לכותרות Accept-CH ו-Origin-Trial.

  4. למשתתפים שמצטרפים לתקופת הניסיון להוצאה משימוש, מומלץ לאפשר לכל הדומיינים של צד שלישי לגשת למחרוזת סוכן המשתמש המלאה. אם הדומיינים של צד שלישי לא יתרחבו למחרוזת המלאה של סוכן המשתמש, הגישה המלאה שלהם למחרוזת של סוכן המשתמש תיחסם, גם אם הרישום לתקופת ניסיון של סוכן המשתמש כבר יצא משימוש. אפשר להעניק למחרוזת סוכן המשתמש גישה מלאה לדומיינים של צד שלישי באמצעות אחת משתי האפשרויות הבאות:

    • צריך להוסיף כותרת Permissions-Policy עם הדומיינים של הצד השלישי שצריכים לקבל את המחרוזת המלאה של סוכן המשתמש.
      • כדי לאשר את כל הדומיינים של צדדים שלישיים, צריך להוסיף Permissions-Policy: ch-ua-full=*.
      • כדי לאפשר רשימת דומיינים של צד שלישי בעלי שם, צריך להוסיף Permissions-Policy: ch-ua-full=(self "https://thirdparty.example.com").
    • מוסיפים מטא תג Accept-CH עם הדומיינים של הצד השלישי שצריכים לקבל את המחרוזת המלאה של סוכן המשתמש (רק ב-Chrome מגרסה 100 ואילך).
      • כדי לאפשר רשימת דומיינים של צד שלישי בעלי שם, צריך להוסיף <meta http-equiv="delegate-ch" value="sec-ch-ua-full https://thirdparty.example.com">.
      • אין אפשרות להעניק גישה לכל הדומיינים של צד שלישי באמצעות * במטא תג.

  5. צריך לטעון את האתר ב-Chrome 100 (ואילך) ולהמשיך לקבל את המחרוזת המלאה של סוכן המשתמש.

הדגמה (דמו)

בכתובת https://uard-ot-demo.glitch.me אפשר לראות הדגמה של תקופת הניסיון (לצד קוד המקור).

איך מוודאים שתקופת הניסיון פועלת?

כדי לוודא שגרסת המקור לניסיון פועלת, בודקים את כותרות הבקשות ומוודאים את הדברים הבאים:

  1. הכותרת של סוכן המשתמש מכילה את הגרסה המלאה. אסור לכלול בו ערכים מופחתים (ברשימת הדוגמאות של מחרוזות סוכן משתמש מופחתות). דרך קלה לדעת היא שהמחרוזת של הגרסה המשנית של Chrome לא צריכה להיות 0.0.0.
  2. הכותרת Sec-CH-UA-Full מוגדרת ל-?1.

הכותרות של התגובה הראשונית שמכילות את אסימון המקור של תקופת הניסיון צריכות להיראות כך:

כותרות הבקשות הבאות שמכילות את המחרוזת המלאה של סוכן המשתמש צריכות להיראות כך:

איך מפסיקים להשתתף בתקופת הניסיון להוצאה משימוש של סוכן המשתמש?

בכל שלב בתקופת הניסיון, אפשר להפסיק את ההשתתפות ולקבל את המחרוזת המצומצמת של סוכן המשתמש. כדי להפסיק להשתתף בתוכנית:

  1. שולחים כותרת Accept-CH בתגובת ה-HTTP שלא כוללת את Sec-CH-UA-Full. שימו לב ש-Accept-CH עם ערך ריק היא דרך חוקית לעשות זאת אם האתר לא מבקש רמזים אחרים ללקוח.
  2. צריך להסיר את הכותרת Origin-Trial של תקופת הניסיון להוצאה משימוש של סוכן המשתמש מתגובת ה-HTTP.
  3. אם המדיניות מוגדרת, מסירים את Sec-CH-UA-Full מהכותרת Critical-CH בתגובת ה-HTTP.

מה ההבדל בין תקופת הניסיון הזו לבין גרסאות מקור אחרות של סוכן המשתמש?

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

השיטה השנייה שמוזכרת כאן היא תקופת ניסיון להוצאה משימוש, שמיועדת לאתרים שצריכים עוד קצת זמן כדי לעבור ל-User-Agent Client Hints API. הוא מאפשר לאתרים להמשיך לקבל את המחרוזת המלאה של סוכן המשתמש.

כמה זמן תימשך תקופת הניסיון להוצאה משימוש?

תקופת הניסיון של ההוצאה משימוש של הפחתת סוכן המשתמש תפעל מ-Chrome 100 עד Chrome 115. Chrome 116 תהיה הגרסה הראשונה שבה תישלח רק מחרוזת סוכן המשתמש המצומצמת לחלוטין.

איך אפשר לשתף משוב על תקופת הניסיון של הפחתת ניכוי הסוכן המשתמש?

שולחים כל בעיה או משוב למאגר GitHub לצמצום של סוכן המשתמש.