פתרון בעיות בגרסאות המקור לניסיון של Chrome

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

רשימת המשימות

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

כדאי לנסות!

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

• ot-meta.glitch.me: אסימון במטא תג מסוג origin-trial
• ot-header.glitch.me: אסימון בכותרת התגובה Origin-Trial
• ot-3p.glitch.me: אסימון שהוחדר על ידי סקריפט של צד שלישי
• ot-iframe.glitch.me: גרסת המקור לניסיון של התכונה שמתבצעת ממנה גישה מ-iframe
• ot-iframe-3p.glitch.me: דוגמאות ל-iframe ממקורות שונים

שימוש בכלי הפיתוח ל-Chrome לבדיקת אסימונים

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

כדי לבדוק את האסימונים בגרסת המקור לניסיון שזמינים לתת-מסגרת, צריך להרחיב את המסגרת העליונה. לדוגמה, בדף ההדגמה שב-ot-iframe.glitch.me, תוכלו לראות שהדף ב-iframe מספק אסימון.

• סטטוס האסימון: האם לדף יש אסימון חוקי. שימו לב: בחלק מגרסאות המקור עשויות להיות גורמים אחרים, כמו הגבלות גיאוגרפיות, והמשמעות היא שהתכונה של גרסת המקור לניסיון לא תהיה זמינה, למרות שיש אסימון תקף. קודי הסטטוס של כלי הפיתוח ל-Chrome מסבירים את המשמעות של כל אחד מהקודים של גרסאות המקור לניסיון.
• Origin: מקור האינטרנט שרשום לאסימון.
• תאריך תפוגה: התאריך והשעה המקסימליים (האחרונים) האפשריים לתפוגה של האסימון, שבדרך כלל תואמים לסוף תקופת הניסיון. הערך הזה לא זהה לערך valid עד date של האסימון שמוצג בקטע My Registrations, שמראה למשך כמה זמן האסימון תקף כרגע, ואפשר להאריך אותו.
• הגבלת שימוש: מגבלות שימוש, שאפשר להגדיר לתקופות ניסיון מסוימות.
• צד שלישי: מציין אם מופעלת התאמה של צד שלישי עבור האסימון. האפשרות הזו זמינה בחלק מגרסאות המקור לניסיון, כאשר הגישה לתכונה לניסיון במספר אתרים מתבצעת באמצעות סקריפטים של צד שלישי.
• התאמה לתת-דומיינים: האם התאמה לתת-דומיין מופעלת עבור האסימון. כך אפשר לבדוק תכונה לניסיון של המקור בכמה תת-דומיינים של מקור, בלי שיהיה צורך באסימון שונה לכל תת-דומיין.

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

קודי הסטטוס של כלי הפיתוח ל-Chrome

• פג תוקף: תאריך התפוגה של האסימון חלף. תצטרכו לחדש את האסימון כדי ליצור אסימון חדש עם תאריך תפוגה חדש.
  קוד מקור

• FeatureDisabled: תקופת הניסיון מושבתת כרגע לשימוש.
  קוד מקור

• FeatureDisabledForUser: האסימון הזה הוגדר כמושבת עבור המשתמש הנוכחי על ידי הגבלת שימוש חלופית. עיינו בקטע 'החרגות של קבוצות משנה של משתמשים' במסמך העיצוב.
  קוד מקור 1
  קוד מקור 2

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

• InvalidSignature: באסימון יש חתימה לא חוקית או שגויה.
  קוד מקור

• פורמט שגוי: האסימון שגוי ולא ניתן לנתח אותו.
  קוד מקור

• NotSupported: גרסת המקור לניסיון שמוגדרת באמצעות האסימון לא נתמכת ב-'embedder' של Chromium: דפדפן כמו Chrome או Edge, WebView או סוכן משתמש אחר.
  קוד מקור

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

• TokenDisabled: האסימון סומן כמושבת ולא ניתן להשתמש בו.
  קוד מקור

• TrialNotAllowed: גרסת המקור לניסיון לא זמינה למשתמש הנוכחי.
  קוד מקור

• UnknownTrial: האסימון מציין שם תכונה שלא תואם לאף גרסת ניסיון ידועה.
  קוד מקור

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

• WrongVersion: גרסת האסימון שגויה: בשלב הזה יש תמיכה רק בגרסאות 2 ו-3 של האסימון.
  קוד מקור

---

זה לא עובד! 🤔

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

הבדיקה מתבצעת ב-Chrome, לא ב-Chromium או בדפדפן אחר

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

גרסאות המקור לניסיון זמינות גם ב-Firefox וב-Microsoft Edge. הרשמה לגרסת מקור לניסיון של Firefox או Edge לא תפעיל תכונה ב-Chrome.

גרסת המקור לניסיון מופעלת בגרסאות Chrome שיש להן גישה לאתר שלך

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

אפשר לבדוק את זמינות הגרסה בדף ההרשמה של תקופת הניסיון:

כדי לבדוק באיזו גרסה של Chrome אתם משתמשים, צריך להיכנס לכתובת chrome://version.

גרסת המקור לניסיון לא מושבתת בהגדרות Chrome

אם משתמש מדווח שתכונה מסוימת לא פועלת עבורו, צריך לבדוק שהתכונה לא מושבתת בהגדרות Chrome. לדוגמה, אפשר להשבית את התכונות של ארגז החול לפרטיות בדף chrome://settings/privacySandbox.

מילות המפתח והתחביר נכונים

חשוב להשתמש במילות מפתח ובתחביר מתאימים לאסימונים של גרסת המקור לניסיון.

לשימוש מאינטראקציה ישירה, ניתן לספק אסימון במטא תג origin-trial:

<meta http-equiv="origin-trial" content="Aj4DysCv3VjknU3...">

לחלופין, אפשר לספק אסימון בכותרת תגובה של Origin-Trial. לפניכם דוגמה לשימוש ב-Express ב-Node.js:

app.use(function(req, res, next) {
  res.setHeader('Origin-Trial', 'Aj4DysCv3VjknU3...')
  next();
});

אפשר לספק אסימונים גם באמצעות JavaScript:

function addTrialToken(tokenContents) {
  const tokenElement = document.createElement('meta');
  tokenElement.httpEquiv = 'origin-trial';
  tokenElement.content = tokenContents;
  document.head.appendChild(tokenElement);
}

המקור של אסימון מהדומיין הנוכחי תואם למקור הדף

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

לדוגמה, אם בחרתם באפשרות https://example.com בתור מקור האינטרנט:

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

יש לבדוק שהערך הזה תואם לאסימון שנעשה בו שימוש בדף שאיתו מנסים לפתור את הבעיה.

לקבלת אסימון שסופק במטא תג, בודקים את קוד ה-HTML:

  <meta http-equiv="origin-trial" content="Aj4DysCv3VjknU3...">

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

אסימון מהדומיין הנוכחי מוצג מהמקור שמשתמש בו

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

המקור הרשום באסימון חייב להתאים למקור ששולח אותו.

המקור של אסימון של צד שלישי תואם למקור הסקריפט

אפשר להירשם כדי להשתתף בגרסת מקור לניסיון של סקריפטים שמוחדרים למקורות אחרים.

לדוגמה: אם רוצים שסקריפטים שמוצגים מ-javascript-library.example ישתתפו בגרסת מקור לניסיון, צריך לרשום אסימון עם התאמה של צד שלישי עבור javascript-library.example.

ערך המקור של אסימון של צד שלישי חייב להתאים למקור של הסקריפט שמחדיר אותו.

הסקריפט של צד שלישי משתמש באסימון של צד שלישי

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

בסקריפטים של צד שלישי צריך להשתמש באסימונים עם התאמה של צד שלישי מופעלת, שיוחדרו דרך הסקריפט עצמו (לא נכלל במטא תג או בכותרת של האתר) באמצעות קוד כמו בדוגמה הבאה:

function addTrialToken(tokenContents) {
  const tokenElement = document.createElement('meta');
  tokenElement.httpEquiv = 'origin-trial';
  tokenElement.content = tokenContents;
  document.head.appendChild(tokenElement);
}

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

אסימונים של צד שלישי מאומתים מול מקור הסקריפט שהחדיר אותם, אבל לסקריפטים בשורה ולתגי <meta> בתגי עיצוב סטטיים אין מקור (כלומר, כתובת URL של מקור).

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

אפשר לראות הדגמה לכך בכתובת ot-iframe-3p.glitch.me.

הגישה לתכונות של גרסת הניסיון המקורית נתמכת עבור השיטה שמשמשת למתן אסימון לניסיון

כדי לקבל גישה לחלק מהתכונות של גרסת המקור לניסיון, תצטרכו לספק אסימון לניסיון באופן ספציפי. לדוגמה, הדרך היחידה להפעיל גישה לגרסת המקור לניסיון עבור קובצי שירות (service worker) ועובדים משותפים היא לספק אסימון בכותרת Origin-Trial.

התאמה בין תתי-דומיינים מופעלת לאסימון שנעשה בו שימוש בתת-דומיין

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

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

אפשר גם להתאים תת-דומיינים לאסימונים של צד שלישי:

אסימונים לתת-דומיינים לא יונפקו למקורות שנמצאים ברשימת הסיומות הציבוריות. לדוגמה, אי אפשר לרשום מקור כמו https://appspot.com או https://github.io, אבל אפשר לרשום דומיינים מהמקור הזה, כמו https://example.appspot.com או https://example.github.io.

האסימון עדיין תקף

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

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

אם האסימון עדיין תקף, בכלי הפיתוח ל-Chrome יוצג הסטטוס Success:

אם פג התוקף של האסימון שלכם, כלי הפיתוח יציגו את הסטטוס Expired, ובדף My Registrations יוצג הקטע Expired Tokens.

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

אפשר לבדוק את תאריך הסיום של גרסת המקור לניסיון בדף ההרשמה של הגרסה:

בתקופות ניסיון שהסתיימו, כלי הפיתוח יציג משהו כזה:

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

גרסת המקור לניסיון זמינה למשתמש הנוכחי

חלק מגרסאות המקור לניסיון לא זמינות למשתמשים מסוימים, גם אם סופק אסימון תקין.

אם אין תקופת ניסיון זמינה למשתמש הנוכחי, כלי הפיתוח ל-Chrome יציג אזהרה מסוג TrialNotAllowed:

מידע על הגבלות השימוש והזמינות יסופק עבור כל גרסת מקור לניסיון.

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

לא חרגת מהגבלות השימוש בגרסת המקור לניסיון

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

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

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

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

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

מסגרות iframe מספקות אסימונים משלהן

כדי לאפשר גישה לתכונת מקור לניסיון, iframe חייב לספק אסימון במטא תג, בכותרת HTTP או באופן פרוגרמטי. מסגרות iframe לא מקבלות בירושה את הגישה לתכונות שמופעלות לדפים שמכילים אותן.

התג ot-iframe.glitch.me מדגים את הגישה לפיצ'ר בגרסת מקור לניסיון מ-iframe. ב-ot-iframe-3p.glitch.me יש מספר דוגמאות למסגרות iframe ממקורות שונים.

מדיניות ההרשאות מוגדרת כראוי

יכול להיות שחלק מהתכונות של גרסת המקור לניסיון יושפעו מכותרת של Permissions-Policy (נקראה בעבר הכותרת Feature-Policy). תוכלו לבדוק זאת בכוונת הניסוי לגבי התכונה לניסיון, או בתיעוד למפתחים עבור התכונה ב-web.dev או ב-developer.chrome.com/blog.

כדאי לוודא שהתכונה שאליה אתם מנסים לגשת לא חסומה על ידי הנחיה Permissions-Policy. אפשר לבדוק את כותרות התגובות בחלונית של Chrome DevTools Network, ולהציג את הרשימה המלאה של התכונות המורשות בחלונית Application.

מה לגבי העובדים?

אפשר להפעיל את התכונות לניסיון של גרסת המקור שזמינות ל-Service Workers, לעובדים משותפים ולעובדים ייעודיים. עם זאת, הדרך היחידה לאפשר גישה ל-Service Workers ול-workers היא לספק אסימון בכותרת Origin-Trial.

עובדים ייעודיים יורשים גישה לתכונות שמופעלות על ידי מסמך ההורה שלהם.

האסימון מסופק לפני שניגשים לתכונה

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

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

• אסימון במטא תג
• אסימון בכותרת
• גישה לתכונה ב-iframe
• האסימון הוחדר על ידי סקריפט של צד שלישי
• ot-iframe-3p.glitch.me: דוגמאות ל-iframe ממקורות שונים

למידע נוסף

• תחילת העבודה עם גרסאות המקור לניסיון של Chrome
• גרסאות מקור לניסיון של צד שלישי
• מדריך לניסיון גרסת מקור למפתחי אתרים
• הסבר על תקופת הניסיון של המקור
• הפעלת גרסת מקור לניסיון
• תהליך ההשקה של תכונות חדשות ב-Chromium
• כוונה להסביר: הסרת המסתורין של תהליך המשלוח של ההבהוב
• שימוש בגרסאות מקור לניסיון ב-Microsoft Edge
• גרסאות מקור לניסיון של Firefox