ภาพรวมรันไทม์ V8

ใน Apps Script และ JavaScript สภาพแวดล้อมรันไทม์หรือสภาพแวดล้อมรันไทม์จะมีเครื่องมือ JavaScript ที่แยกวิเคราะห์และเรียกใช้โค้ดสคริปต์ รันไทม์มีกฎสำหรับวิธีเข้าถึงหน่วยความจำ วิธีที่โปรแกรมโต้ตอบกับระบบปฏิบัติการของคอมพิวเตอร์ และไวยากรณ์ของโปรแกรมที่ถูกกฎหมาย เว็บเบราว์เซอร์แต่ละเว็บมีสภาพแวดล้อมรันไทม์สำหรับ JavaScript

ก่อนหน้านี้ Apps Script ขับเคลื่อนโดยโปรแกรมตีความ Rhino JavaScript ของ 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 () => {}

เรียกเมธอดออบเจ็กต์จากทริกเกอร์และ Callback

สคริปต์ที่ใช้ V8 จะเรียกใช้เมธอดออบเจ็กต์และเมธอดแบบคงที่ของคลาสจากที่ซึ่งคุณเรียกใช้เมธอดไลบรารีได้อยู่แล้ว ซึ่งมีตัวอย่างดังต่อไปนี้

• ทริกเกอร์ไฟล์ Manifest ส่วนเสริมของ Google Workspace
• ทริกเกอร์ที่ติดตั้งได้
• รายการในเมนูใน Google Workspace เครื่องมือแก้ไข
• ฟังก์ชัน Callback ของผู้ใช้ตามที่อธิบายไว้ในตัวอย่างโค้ด ScriptApp.newStateToken()

ตัวอย่าง V8 ต่อไปนี้แสดงการใช้เมธอดออบเจ็กต์เมื่อสร้างรายการในเมนูใน Google ชีต

function onOpen() {
  var 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();
}

var menu = {
  item1: function() {
    SpreadsheetApp.getUi().alert('You clicked: First item');
  },
  item2: function() {
    SpreadsheetApp.getUi().alert('You clicked: Second item');
  }
}

ดูบันทึก

Apps Script มีบริการการบันทึก 2 บริการ ได้แก่ บริการ Logger และคลาส console บริการทั้ง 2 นี้จะเขียนบันทึกไปยังบริการStackdriver Logging เดียวกัน

หากต้องการแสดงบันทึก Logger และ console ให้คลิกบันทึกการดำเนินการที่ด้านบนของเครื่องมือแก้ไขสคริปต์

ดูการดำเนินการ

หากต้องการดูประวัติการดำเนินการของสคริปต์ ให้เปิดโปรเจ็กต์ Apps Script จากนั้นคลิกการดำเนินการ playlist_play ทางด้านซ้าย

ตัวอย่างไวยากรณ์ V8

ต่อไปนี้เป็นรายการฟีเจอร์ไวยากรณ์ยอดนิยมที่พร้อมใช้งานสำหรับสคริปต์ที่ใช้รันไทม์ V8

letและconst

คีย์เวิร์ด let และ const ช่วยให้คุณกําหนดตัวแปรภายในของขอบเขตการบล็อกและค่าคงที่ของขอบเขตบล็อกได้ตามลำดับ

// V8 runtime
let s = "hello";
if (s === "hello") {
  let 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));
      

คลาส

คลาสมอบวิธีการจัดระเบียบโค้ดตามแนวคิดด้วยการรับค่า คลาสใน 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 array = [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
var data = {a: 12, b: false, c: 'blue'};
var {a, c} = data;
console.log(a, c);  // Outputs 12 "blue"


var array = [1, 2, 3];
var [x, y, z] = array;
console.log(x, y, z);  // Outputs 1 2 3


      

ลิเทอรัลเทมเพลต

ลิเทอรัลเทมเพลต คือสัญพจน์สตริงที่อนุญาตนิพจน์ที่ฝัง ซึ่งช่วยให้คุณหลีกเลี่ยงคำสั่งการต่อสตริงที่ซับซ้อนขึ้นได้

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

// V8 runtime
var name = `Hi ${first} ${last}.`;
var 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
var 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
var 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

อีกทางเลือกหนึ่งคือระบุรันไทม์ของสคริปต์โดยตรงโดยแก้ไขไฟล์ Manifest ของสคริปต์โดยทำดังนี้

1. เปิดโครงการ Apps Script
2. คลิกการตั้งค่าโปรเจ็กต์ settings ทางด้านซ้าย
3. เลือกช่องทำเครื่องหมายแสดงไฟล์ Manifest "appsscript.json" ในเครื่องมือแก้ไข
4. ทางด้านซ้าย ให้คลิกตัดต่อวิดีโอ code > appsscript.json
5. ในไฟล์ Manifest ของ appsscript.json ให้ตั้งค่าช่อง runtimeVersion เป็นค่า V8
6. คลิกบันทึกโปรเจ็กต์ save ที่ด้านบน

การย้ายข้อมูลสคริปต์ไปยัง V8 จะอธิบายขั้นตอนอื่นๆ ที่คุณควรทำเพื่อให้แน่ใจว่าสคริปต์ของคุณทำงานได้ดีเมื่อใช้ V8

กำลังเปิดใช้รันไทม์ของ Rhino

หากสคริปต์ของคุณใช้ V8 และคุณต้องเปลี่ยนไปใช้รันไทม์ของ Rhino เดิม ให้ทำตามขั้นตอนต่อไปนี้

1. เปิดโครงการ Apps Script
2. คลิกการตั้งค่าโปรเจ็กต์ settings ทางด้านซ้าย
3. ล้างช่องทำเครื่องหมายเปิดใช้รันไทม์ของ Chrome V8

หรือแก้ไขไฟล์ Manifest ของสคริปต์โดยทำดังนี้

1. เปิดโครงการ Apps Script
2. คลิกการตั้งค่าโปรเจ็กต์ settings ทางด้านซ้าย
3. เลือกช่องทำเครื่องหมายแสดงไฟล์ Manifest "appsscript.json" ในเครื่องมือแก้ไข
4. ทางด้านซ้าย ให้คลิกตัดต่อวิดีโอ code > appsscript.json
5. ในไฟล์ Manifest ของ appsscript.json ให้ตั้งค่าช่อง runtimeVersion เป็นค่า DEPRECATED_ES5
6. คลิกบันทึกโปรเจ็กต์ save ที่ด้านบน

ฉันจะย้ายข้อมูลสคริปต์ที่มีอยู่ได้อย่างไร

คู่มือการย้ายข้อมูลสคริปต์ไปยัง V8 จะอธิบายขั้นตอนที่คุณต้องทำเพื่อย้ายสคริปต์ที่มีอยู่ไปใช้ V8 ซึ่งรวมถึงการเปิดใช้รันไทม์ V8 และตรวจสอบสคริปต์เพื่อหาความไม่เข้ากันที่ทราบ

การย้ายข้อมูลสคริปต์ไปยัง V8 โดยอัตโนมัติ

ตั้งแต่วันที่ 18 กุมภาพันธ์ 2020 เป็นต้นไป Google จะเริ่มทยอยย้ายข้อมูลสคริปต์ที่มีอยู่ซึ่งผ่านการทดสอบความเข้ากันได้แบบอัตโนมัติไปยัง V8 สคริปต์ที่ได้รับผลกระทบยังคงทำงานตามปกติหลังจากการย้ายข้อมูล

หากคุณต้องการเลือกไม่ใช้สคริปต์การย้ายข้อมูลอัตโนมัติ ให้ตั้งค่าช่อง runtimeVersion ในไฟล์ Manifest เป็น DEPRECATED_ES5 คุณเลือกที่จะย้ายสคริปต์ไปยัง V8 ด้วยตนเองได้ทุกเมื่อหลังจากนั้น

ฉันจะรายงานข้อบกพร่องได้อย่างไร

คู่มือสนับสนุนอธิบายวิธีรับความช่วยเหลือเกี่ยวกับการเขียนโปรแกรมใน Stack Overflow, ค้นหารายงานปัญหาที่มีอยู่, รายงานข้อบกพร่องใหม่ และส่งคำขอฟีเจอร์ใหม่