דף זה תורגם על ידי Cloud Translation API.

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 יש הרבה פחות הגבלות מאשר מצבי ארגז החול האחרים, והוא פועל במהירות הגבוהה ביותר, אבל הוא לא פועל בכלל בדפדפנים ישנים מסוימים, כולל Internet Explorer 9. אפשר לקרוא את מצב ארגז החול גם בסקריפט בצד הלקוח על ידי בדיקת google.script.sandbox.mode. שימו לב שהמאפיין הזה מחזיר את המצב בפועל בלקוח, שעשוי להיות שונה מהמצב המבוקש בשרת אם המצב המבוקש לא נתמך בדפדפן של המשתמש.

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

תכונות

נכס	תיאור	התיאור
`EMULATED`	`Enum`	מצב ארגז חול מדור קודם שמדמה את המצב הקפדני של ECMAScript 5 תוך שימוש בתכונות שזמינות ב-ECMAScript 3 בלבד. מצב זה היה ברירת המחדל לפני פברואר 2014. `EMULATED` השקיעה ב-10 בדצמבר 2015. כל הסקריפטים שמנסים להשתמש ב-`EMULATED` ישתמשו עכשיו ב-`IFRAME`.
`IFRAME`	`Enum`	מצב ארגז חול שמשתמש בהרצה בארגז חול (sandboxing) של iframe במקום בטכנולוגיית ארגז חול של Caja, שמשמשת את המצבים `EMULATED` ו-`NATIVE`. מצב זה הוא ברירת המחדל בסקריפטים חדשים החל מ-12 בנובמבר 2015, ועבור כל הסקריפטים החל מ-6 ביולי 2016. המצב הזה מחייב הרבה פחות הגבלות מאשר מצבי ה-Sandbox האחרים, והוא פועל במהירות הגבוהה ביותר, אבל הוא לא פועל בכלל בדפדפנים מסוימים ישנים, כולל Internet Explorer 9.
`NATIVE`	`Enum`	מצב ארגז חול שמבוסס על מצב קפדני של ECMAScript 5. מצב ארגז חול שמבוסס על מצב קפדני של ECMAScript 5. המצב הזה יצא משימוש ב-6 ביולי 2016. כל הסקריפטים משתמשים עכשיו במצב `IFRAME`.