Trang này được dịch bởi Cloud Translation API.

Tổng quan về thời gian chạy V8

Trong Apps Script và JavaScript, thời gian chạy hoặc môi trường thời gian chạy chứa công cụ JavaScript giúp phân tích cú pháp và thực thi mã tập lệnh. Môi trường thời gian chạy cung cấp các quy tắc về cách truy cập bộ nhớ, cách chương trình có thể tương tác với hệ điều hành của máy tính và cú pháp chương trình hợp lệ. Mỗi trình duyệt web đều có môi trường thời gian chạy cho JavaScript.

Trước đây, Apps Script được cung cấp bởi trình thông dịch JavaScript Rhino của Mozilla. Mặc dù Rhino cung cấp một cách thuận tiện để Apps Script thực thi các tập lệnh của nhà phát triển, nhưng nó cũng liên kết Apps Script với một phiên bản JavaScript cụ thể (ES5). Nhà phát triển Apps Script không thể sử dụng cú pháp và tính năng JavaScript hiện đại hơn trong các tập lệnh bằng thời gian chạy Rhino.

Để giải quyết mối lo ngại này, Apps Script hiện được hỗ trợ bởi thời gian chạy V8 cung cấp năng lượng cho Chrome và Node.js. Bạn có thể di chuyển các tập lệnh hiện có sang V8 để tận dụng cú pháp và tính năng JavaScript hiện đại.

Trang này mô tả các tính năng mới mà V8 hỗ trợ và cách bạn có thể bật V8 để sử dụng trong tập lệnh. Bài viết Di chuyển tập lệnh sang V8 mô tả các bước di chuyển tập lệnh hiện có để sử dụng môi trường thời gian chạy V8.

Các tính năng của môi trường thời gian chạy V8

Các tập lệnh sử dụng môi trường thời gian chạy V8 có thể tận dụng các tính năng sau:

Cú pháp ECMAScript hiện đại

Bạn có thể sử dụng cú pháp ECMAScript hiện đại trong các tập lệnh được hỗ trợ bởi môi trường thời gian chạy V8. Cú pháp này bao gồm let, const và nhiều tính năng phổ biến khác.

Hãy xem ví dụ về cú pháp V8 để biết danh sách ngắn về các điểm cải tiến cú pháp phổ biến mà bạn có thể thực hiện bằng cách sử dụng môi trường thời gian chạy V8.

Cải thiện khả năng phát hiện hàm

Cải thiện tính năng phát hiện hàm Apps Script cho các tập lệnh sử dụng V8. Môi trường thời gian chạy mới nhận dạng các định dạng định nghĩa hàm sau:

      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 () => {}

Gọi phương thức đối tượng từ trình kích hoạt và lệnh gọi lại

Các tập lệnh sử dụng V8 có thể gọi các phương thức đối tượng và phương thức tĩnh của lớp từ những vị trí mà bạn có thể gọi các phương thức thư viện. Các địa điểm này bao gồm:

Trình kích hoạt tệp kê khai của tiện ích bổ sung Google Workspace
Trình kích hoạt có thể cài đặt
Các mục trong trình đơn của Google Workspace trình chỉnh sửa
Hàm gọi lại của người dùng, chẳng hạn như hàm được mô tả trong mẫu mã ScriptApp.newStateToken().

Ví dụ sau về V8 cho thấy cách sử dụng các phương thức đối tượng khi tạo các mục trong trình đơn trong Google Trang tính:

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');
  }
}

Xem nhật ký

Apps Script cung cấp hai dịch vụ ghi nhật ký: dịch vụ Logger và lớp console. Cả hai dịch vụ này đều ghi nhật ký vào cùng một Dịch vụ ghi nhật ký Stackdriver.

Để hiển thị nhật ký Logger và console, ở đầu trình chỉnh sửa tập lệnh, hãy nhấp vào Nhật ký thực thi.

Xem lượt thực thi

Để xem nhật ký thực thi của tập lệnh, hãy mở dự án Apps Script rồi nhấp vào Lần thực thi ở bên trái.

Ví dụ về cú pháp V8

Sau đây là danh sách ngắn các tính năng cú pháp phổ biến có sẵn cho các tập lệnh sử dụng môi trường thời gian chạy V8.

`let` và `const`

Các từ khoá let và const cho phép bạn xác định biến cục bộ trong phạm vi khối và hằng số trong phạm vi khối tương ứng.

// 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

Hàm mũi tên

Hàm mũi tên cung cấp một cách ngắn gọn để xác định các hàm trong biểu thức.

// 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));

Lớp

Lớp cung cấp một phương tiện để sắp xếp mã theo khái niệm với tính năng kế thừa. Các lớp trong V8 chủ yếu là cú pháp so với tính năng kế thừa dựa trên nguyên mẫu 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)

Phân rã các chỉ định

Biểu thức Gán cấu trúc là một cách nhanh chóng để giải nén các giá trị từ mảng và đối tượng thành các biến riêng biệt.

// 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

Giá trị cố định của mẫu

Hằng mẫu là hằng chuỗi cho phép biểu thức được nhúng. Các hàm này giúp bạn tránh phải sử dụng các câu lệnh nối chuỗi phức tạp hơn.

// 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}`;

Tham số mặc định

Tham số mặc định cho phép bạn chỉ định giá trị mặc định cho các tham số của hàm trong phần khai báo hàm. Điều này có thể đơn giản hoá mã trong phần thân hàm vì bạn không cần chỉ định giá trị mặc định một cách rõ ràng cho các tham số bị thiếu.

// 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!"

Chuỗi nhiều dòng

Bạn có thể xác định chuỗi nhiều dòng bằng cách sử dụng cú pháp giống như chuỗi cố định mẫu. Cũng như với các giá trị cố định của mẫu, cú pháp này cho phép bạn tránh việc nối chuỗi và đơn giản hoá định nghĩa chuỗi.

// 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`;

Bật thời gian chạy V8

Nếu một tập lệnh đang sử dụng môi trường thời gian chạy Rhino, bạn có thể chuyển sang V8 bằng cách làm như sau:

Mở dự án Apps Script.
Ở bên trái, hãy nhấp vào biểu tượng Cài đặt dự án .
Chọn hộp đánh dấu Bật thời gian chạy Chrome V8.

Ngoài ra, bạn có thể chỉ định thời gian chạy tập lệnh trực tiếp bằng cách chỉnh sửa tệp kê khai tập lệnh:

Mở dự án Apps Script.
Ở bên trái, hãy nhấp vào biểu tượng Cài đặt dự án .
Chọn hộp đánh dấu Hiện tệp kê khai "appsscript.json" trong trình chỉnh sửa.
Ở bên trái, hãy nhấp vào Trình chỉnh sửa > appsscript.json.
Trong tệp kê khai appsscript.json, hãy đặt trường runtimeVersion thành giá trị V8.
Ở trên cùng, hãy nhấp vào biểu tượng Lưu dự án .

Bài viết Di chuyển tập lệnh sang V8 giải thích các bước khác mà bạn nên thực hiện để đảm bảo tập lệnh hoạt động tốt bằng V8.

Bật môi trường thời gian chạy Rhino

Nếu tập lệnh của bạn đang sử dụng V8 và bạn cần chuyển sang sử dụng môi trường thời gian chạy Rhino ban đầu, hãy làm như sau:

Mở dự án Apps Script.
Ở bên trái, hãy nhấp vào biểu tượng Cài đặt dự án .
Bỏ đánh dấu hộp Bật thời gian chạy Chrome V8.

Ngoài ra, bạn có thể chỉnh sửa tệp kê khai tập lệnh:

Mở dự án Apps Script.
Ở bên trái, hãy nhấp vào biểu tượng Cài đặt dự án .
Chọn hộp đánh dấu Hiện tệp kê khai "appsscript.json" trong trình chỉnh sửa.
Ở bên trái, hãy nhấp vào Trình chỉnh sửa > appsscript.json.
Trong tệp kê khai appsscript.json, hãy đặt trường runtimeVersion thành giá trị DEPRECATED_ES5.
Ở trên cùng, hãy nhấp vào biểu tượng Lưu dự án .

Làm cách nào để di chuyển các tập lệnh hiện có?

Hướng dẫn Di chuyển tập lệnh sang V8 mô tả các bước bạn cần thực hiện để di chuyển một tập lệnh hiện có sang sử dụng V8. Điều này bao gồm việc bật thời gian chạy V8 và kiểm tra tập lệnh để tìm bất kỳ điểm không tương thích nào đã biết.

Di chuyển tập lệnh sang V8 một cách tự động

Kể từ ngày 18 tháng 2 năm 2020, Google sẽ bắt đầu từng bước di chuyển các tập lệnh hiện có đã vượt qua quy trình kiểm thử khả năng tương thích tự động của chúng tôi sang V8. Các tập lệnh bị ảnh hưởng tiếp tục hoạt động bình thường sau khi di chuyển.

Nếu bạn muốn chọn không di chuyển tự động một tập lệnh, hãy đặt trường runtimeVersion trong tệp kê khai thành DEPRECATED_ES5. Bạn có thể chọn di chuyển tập lệnh sang V8 theo cách thủ công bất cứ lúc nào sau đó.

Làm cách nào để báo cáo lỗi?

Hướng dẫn hỗ trợ giải thích cách yêu cầu trợ giúp lập trình trên Stack Overflow, tìm kiếm báo cáo lỗi hiện có, báo cáo lỗi mới và đưa ra yêu cầu về tính năng mới.