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

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

Sam Dutton

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

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




















כדאי לנסות!

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  • NotSupported: גרסת המקור לניסיון שהוגדר על ידי האסימון לא נתמכת ב-Chromium 'embedder': דפדפן כמו 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 ו-Beta.

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

גרסאות מקור לניסיון ב-Chrome דף 'דומיינים של צד ראשון' SameParty עם הדגשה של זמינות Chrome

כדי לבדוק את גרסת 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);
}

המקור של אסימון מאינטראקציה ישירה (First-Party) תואם למקור הדף

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

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

גרסאות מקור לניסיון ב-Chrome דף שבו מוצג הכתובת https://example.com שנבחרה כמקור האינטרנט.

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

גרסאות מקור לניסיון ב-Chrome דף שמציג את ערך האסימון.

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

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

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

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

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

אסימון מאינטראקציה ישירה מוצג מהמקור שמשתמש בו

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

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

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

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

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

גרסאות מקור לניסיון ב-Chrome דף הרשמה שבו מוצגת התאמה של צד שלישי שנבחרה.

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

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

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

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

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 Works ולעובדים משותפים היא מספקים אסימון בכותרת Origin-Trial.

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

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

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

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

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

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

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

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

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

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

גרסאות מקור לניסיון ב-Chrome דף ההרשמות שלי מציג עד תאריך חוקי

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

כלי פיתוח ל-Chrome מידע על גרסאות ניסיון של המקור בחלונית האפליקציה, עם הדגשה של &#39;סטטוס: הצלחה&#39;.

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

גרסאות מקור לניסיון ב-Chrome דף &#39;ההרשמות שלי&#39; מציג אסימונים שפג תוקפם.

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

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

גרסאות מקור לניסיון ב-Chrome דף &#39;דומיינים של צד ראשון&#39; SameParty עם הדגשה של הפרטים הזמינים לתקופת הניסיון.

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

כלי פיתוח ל-Chrome מידע על גרסאות ניסיון של המקור בחלונית Application, המציג את ValidTokenNotProvided ו-Status Expiration

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

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

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

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

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

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

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

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

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

עם זאת, למעט במקרים נדירים, השימוש בגרסת המקור לניסיון מוגבל ל-0.5% לכל היותר מכל טעינות הדפים ב-Chrome. תכונת המקור לניסיון תושבת אם השימוש הכולל של כל משתמשי 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 של Google. אפשר לבדוק את כותרות התגובות בחלונית 'רשת כלי הפיתוח ל-Chrome', ולראות את רשימה מלאה של התכונות המותרות בחלונית האפליקציות.

כלי פיתוח ל-Chrome חלונית האפליקציה שמציגה את התכונה Permissions Policy Allowed.

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

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

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

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

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

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

למידע נוסף