סקירה כללית על סביבת זמן הריצה של V8

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

בעבר, Apps Script הופעל על ידי מתורגמן JavaScript של Rhino מבית Mozilla. ‫Rhino סיפק דרך נוחה ל-Apps Script להריץ סקריפטים של מפתחים, אבל הוא גם קשר את Apps Script לגרסה ספציפית של JavaScript‏ (ES5). מפתחי Apps Script לא יכולים להשתמש בתחביר ובמאפיינים מודרניים יותר של JavaScript בסקריפטים שמשתמשים בסביבת זמן הריצה של Rhino.

כדי לפתור את הבעיה הזו, Apps Script נתמך עכשיו על ידי זמן הריצה V8 שמפעיל את Chrome ו-Node.js. אתם יכולים להעביר סקריפטים קיימים ל-V8 כדי ליהנות מהתחביר ומהתכונות המודרניים של JavaScript.

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

תכונות של זמן הריצה V8

סקריפטים שמשתמשים בזמן הריצה של V8 יכולים ליהנות מהתכונות הבאות:

תחביר ECMAScript מודרני

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

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

זיהוי פונקציות משופר

זיהוי הפונקציות ב-Apps Script משופר בסקריפטים שמשתמשים ב-V8. סביבת זמן הריצה החדשה מזהה את הפורמטים הבאים של הגדרות פונקציות:

      function normalFunction() {}       async function asyncFunction() {}       function* generatorFunction() {}        var varFunction = function() {}       let letFunction = function() {}       const constFunction = function() {}        var namedVarFunction = function alternateNameVarFunction() {}       let namedLetFunction = function alternateNameLetFunction() {}       const namedConstFunction = function alternateNameConstFunction() {}        var varAsyncFunction = async function() {}       let letAsyncFunction = async function() {}       const constAsyncFunction = async function() {}        var namedVarAsyncFunction = async function alternateNameVarAsyncFunction() {}       let namedLetAsyncFunction = async function alternateNameLetAsyncFunction() {}       const namedConstAsyncFunction = async function alternateNameConstAsyncFunction() {}        var varGeneratorFunction = function*() {}       let letGeneratorFunction = function*() {}       const constGeneratorFunction = function*() {}        var namedVarGeneratorFunction = function* alternateNameVarGeneratorFunction() {}       let namedLetGeneratorFunction = function* alternateNameLetGeneratorFunction() {}       const namedConstGeneratorFunction = function* alternateNameConstGeneratorFunction() {}        var varLambda = () => {}       let letLambda = () => {}       const constLambda = () => {}        var varAsyncLambda = async () => {}       let letAsyncLambda = async () => {}       const constAsyncLambda = async () => {}

הפעלת שיטות של אובייקט Call מטריגרים ומקודים להתקשרות חזרה

סקריפטים שמשתמשים ב-V8 יכולים להפעיל שיטות של אובייקטים ושיטות סטטיות של מחלקות ממקומות שבהם כבר הייתה לכם אפשרות להפעיל שיטות של ספריות. המקומות האלה כוללים את:

• טריגרים של מניפסט בתוספים ל-Google Workspace
• טריגרים שאפשר להתקין
• אפשרויות בתפריט של Google Workspace כלי עריכה
• פונקציות קריאה חוזרת של המשתמש, כמו זו שמתוארת בדוגמת הקוד ScriptApp.newStateToken().

בדוגמה הבאה של V8 אפשר לראות איך משתמשים בשיטות של אובייקטים כשיוצרים פריטים בתפריט ב-Google Sheets:

function onOpen() {   const ui = SpreadsheetApp.getUi(); // Or DocumentApp, SlidesApp, or FormApp.   ui.createMenu('Custom Menu')       .addItem('First item', 'menu.item1')       .addSeparator()       .addSubMenu(ui.createMenu('Sub-menu')           .addItem('Second item', 'menu.item2'))       .addToUi(); }  const menu = {   item1: function() {     SpreadsheetApp.getUi().alert('You clicked: First item');   },   item2: function() {     SpreadsheetApp.getUi().alert('You clicked: Second item');   } } 

צפייה ביומנים

ב-Apps Script יש שני שירותי רישום ביומן: השירות Logger והמחלקה console. שני השירותים האלה כותבים יומנים לאותו שירות Stackdriver Logging.

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

הצגת הביצועים

כדי לראות את היסטוריית הביצוע של הסקריפט, פותחים את פרויקט Apps Script ובצד ימין לוחצים על Executions (ביצועים) playlist_play.

דוגמאות לתחביר ב-V8

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

let וגם const

מילות המפתח let ו-const מאפשרות להגדיר משתנים מקומיים בהיקף של בלוק וקבועים בהיקף של בלוק, בהתאמה.

// V8 runtime let s = "hello"; if (s === "hello") {   s = "world";   console.log(s);  // Prints "world" } console.log(s);  // Prints "hello"  const N = 100; N = 5; // Results in TypeError       

פונקציות חץ

פונקציות חץ מספקות דרך קומפקטית להגדרת פונקציות בתוך ביטויים.

// Rhino runtime function square(x) {   return x * x; }  console.log(square(5));  // Outputs 25       

// V8 runtime const square = x => x * x; console.log(square(5));  // Outputs 25  // Outputs [1, 4, 9] console.log([1, 2, 3].map(x => x * x));       

שיעורים

Classes מספקות אמצעי לארגון קוד באופן קונספטואלי באמצעות ירושה. מחלקות ב-V8 הן בעיקר תחביר נוח לשימוש בירושה מבוססת-אב-טיפוס של JavaScript.

// V8 runtime class Rectangle {   constructor(width, height) { // class constructor     this.width = width;     this.height = height;   }    logToConsole() { // class method     console.log(`Rectangle(width=${this.width}, height=${this.height})`);   } }  const r = new Rectangle(10, 20); r.logToConsole();  // Outputs Rectangle(width=10, height=20)       

הקצאות של פירוק מבנה

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

// Rhino runtime var data = {a: 12, b: false, c: 'blue'}; var a = data.a; var c = data.c; console.log(a, c);  // Outputs 12 "blue"  var a = [1, 2, 3]; var x = a[0]; var y = a[1]; var z = a[2]; console.log(x, y, z);  // Outputs 1 2 3       

// V8 runtime const data = {a: 12, b: false, c: 'blue'}; const {a, c} = data; console.log(a, c);  // Outputs 12 "blue"   const array = [1, 2, 3]; const [x, y, z] = array; console.log(x, y, z);  // Outputs 1 2 3         

תבניות מילוליות

Template literals הם מחרוזות ליטרליות שמאפשרות הבעות מוטמעות. הם מאפשרים לכם להימנע מהצהרות מורכבות יותר של שרשור מחרוזות.

// Rhino runtime var name =   'Hi ' + first + ' ' + last + '.'; var url =   'http://localhost:3000/api/messages/'   + id;       

// V8 runtime const name = `Hi ${first} ${last}.`; const url =   `http://localhost:3000/api/messages/${id}`;         

פרמטרים שמוגדרים כברירת מחדל

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

// Rhino runtime function hello(greeting, name) {     greeting = greeting || "hello";     name = name || "world";     console.log(         greeting + " " + name + "!"); }  hello();  // Outputs "hello world!"       

// V8 runtime const hello =   function(greeting="hello", name="world") {       console.log(         greeting + " " + name + "!");   }  hello();  // Outputs "hello world!"        

מחרוזות מרובות שורות

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

// Rhino runtime var multiline = "This string is sort of\n" + "like a multi-line string,\n" + "but it's not really one.";       

// V8 runtime const multiline = `This on the other hand, actually is a multi-line string, thanks to JavaScript ES6`;       

הפעלת סביבת זמן הריצה V8

אם סקריפט מסוים משתמש בסביבת זמן הריצה של Rhino, אפשר להעביר אותו ל-V8 באופן הבא:

1. פותחים את פרויקט Apps Script.
2. בצד ימין, לוחצים על הגדרות הפרויקט settings.
3. מסמנים את תיבת הסימון הפעלה של 'סביבת זמן הריצה' של Chrome V8.

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

1. פותחים את פרויקט Apps Script.
2. בצד ימין, לוחצים על הגדרות הפרויקט settings.
3. מסמנים את התיבה הצגת קובץ המניפסט 'appsscript.json' בעורך.
4. בצד ימין, לוחצים על עורך code > appsscript.json.
5. בappsscript.json קובץ המניפסט, מגדירים את השדה runtimeVersion לערך V8.
6. למעלה, לוחצים על שמירת הפרויקט save.

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

הפעלת סביבת זמן הריצה של Rhino

אם הסקריפט שלכם משתמש ב-V8 ואתם רוצים להעביר אותו לשימוש בסביבת זמן הריצה המקורית של Rhino, אתם צריכים לעשות את הפעולות הבאות:

1. פותחים את פרויקט Apps Script.
2. בצד ימין, לוחצים על הגדרות הפרויקט settings.
3. מבטלים את הסימון בתיבת הסימון הפעלת זמן הריצה של Chrome V8.

אפשר גם לערוך את קובץ המניפסט של הסקריפט:

1. פותחים את פרויקט Apps Script.
2. בצד ימין, לוחצים על הגדרות הפרויקט settings.
3. מסמנים את התיבה הצגת קובץ המניפסט 'appsscript.json' בעורך.
4. בצד ימין, לוחצים על עורך code > appsscript.json.
5. בappsscript.json קובץ המניפסט, מגדירים את השדה runtimeVersion לערך DEPRECATED_ES5.
6. למעלה, לוחצים על שמירת הפרויקט save.

איך מעבירים סקריפטים קיימים?

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

העברה אוטומטית של סקריפטים ל-V8

החל מ-18 בפברואר 2020, ‏ Google תתחיל להעביר בהדרגה סקריפטים קיימים שעוברים את בדיקת התאימות האוטומטית שלנו ל-V8. הסקריפטים המושפעים ממשיכים לפעול כרגיל אחרי ההעברה.

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

איך מדווחים על באגים?

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