Enum SandboxMode

enum שמייצג את מצבי ארגז החול שבהם אפשר להשתמש בשביל HtmlService בצד הלקוח סקריפטים. אפשר לגשת לערכים האלה מ-HtmlService.SandboxMode ולהגדיר אותם בשיחה HtmlOutput.setSandboxMode(mode).

כדי לקרוא ל-enum, קוראים למחלקה ההורה, לשם ולמאפיין שלו. לדוגמה, HtmlService.SandboxMode.IFRAME.

המצבים NATIVE ו-EMULATED הוצאו משימוש ב-13 באוקטובר 2015 ושניהם סגורים עכשיו. רק מצב IFRAME נתמך עכשיו.

כדי להגן על המשתמשים מפני הצגה של קוד זדוני ב-HTML או ב-JavaScript, נעשה שימוש בקוד בצד הלקוח שירות HTML פועל בארגז חול של אבטחה שמטיל הגבלות על הקוד. השיטה HtmlOutput.setSandboxMode(mode) מחברי סקריפטים שקיבלו בעבר הרשאה לבחור בין גרסאות שונות של ארגז החול, אבל עכשיו אין לו השפעה. מידע נוסף זמין במאמר המדריך להגבלות בשירות HTML.

במצב IFRAME יש הרבה פחות הגבלות בהשוואה למצבי ה-Sandbox האחרים ופועלים המהיר ביותר, אבל לא פועל כלל בדפדפנים ישנים מסוימים, כולל Internet Explorer 9. אפשר לקרוא את מצב Sandbox גם בסקריפט בצד הלקוח על ידי בדיקה של google.script.sandbox.mode. שימו לב שהמאפיין הזה מחזיר ללקוח את המצב בפועל, עשוי להיות שונה מהמצב המבוקש בשרת אם המצב המבוקש לא נתמך בדפדפן של המשתמש.

<!-- Read the sandbox mode (in a client-side script). -->
<script>
  alert(google.script.sandbox.mode);
</script>