このページは Cloud Translation API によって翻訳されました。

V8 ランタイムの概要

Apps Script と JavaScript では、ランタイムまたはランタイム環境にスクリプトコードを解析して実行する JavaScript エンジンが含まれています。ランタイムは、メモリへのアクセス方法、プログラムがコンピュータのオペレーティングシステムとやり取りする方法、有効なプログラム構文に関するルールを提供します。各ウェブブラウザには JavaScript のランタイム環境があります。

これまで、Apps Script は Mozilla の Rhino JavaScript インタープリタを利用していました。Rhino は Apps Script でデベロッパースクリプトを実行する便利な方法を提供する一方で、Apps Script を特定の JavaScript バージョン（ES5）と結び付ける機能も備えています。Apps Script のデベロッパーは、Rhino ランタイムを使用するスクリプトで最新の JavaScript 構文と機能を使用できません。

この問題に対処するため、Apps Script は Chrome と Node.js を強化する V8 ランタイムでサポートされるようになりました。既存のスクリプトを V8 に移行すると、最新の JavaScript の構文と機能を利用できます。

このページでは、V8 によって有効になる新機能と、V8 を有効にしてスクリプトで使用する方法について説明します。スクリプトの V8 への移行では、既存のスクリプトを V8 ランタイムを使用するように移行する手順について説明しています。

V8 ランタイムの機能

V8 ランタイムを使用するスクリプトでは、次の機能を利用できます。

関数検出の改善

V8 を使用するスクリプトの Apps Script 関数の検出が改善されました。新しいランタイムは、次の関数定義形式を認識します。

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

トリガーとコールバックからオブジェクトメソッドを呼び出す

V8 を使用するスクリプトでは、ライブラリのメソッドを呼び出せる場所からオブジェクトメソッドとクラスの静的メソッドを呼び出すことができます。たとえば、次のような場所です。

Google Workspace アドオンのマニフェストトリガー
インストール可能なトリガー
エディタの Google Workspace メニューアイテム
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 には、Logger サービスと console クラスの 2 つのロギングサービスがあります。これらのサービスは、どちらも同じ Stackdriver Logging サービスにログを書き込みます。

Logger ログと console ログを表示するには、スクリプトエディタの上部にある [実行ログ] をクリックします。

実行を表示

スクリプトの実行履歴を表示するには、Apps Script プロジェクトを開き、左側にある [Executions] をクリックします。

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 に切り替えることができます。

Apps Script プロジェクトを開きます。
左側にある [プロジェクトの設定] をクリックします。
[Chrome V8 ランタイムを有効にする] チェックボックスをオンにします。

スクリプトマニフェストファイルを編集して、スクリプトランタイムを直接指定することもできます。

Apps Script プロジェクトを開きます。
左側にある [プロジェクトの設定] をクリックします。
[「appsscript.json」マニフェストファイルをエディタで表示する] チェックボックスをオンにします。
左側にある [エディタ] > [appsscript.json] をクリックします。
appsscript.json マニフェストファイルで、runtimeVersion フィールドの値を V8 に設定します。
上部にある [プロジェクトを保存] をクリックします。

スクリプトの V8 への移行では、V8 を使用してスクリプトが適切に機能するために必要なその他の手順について説明しています。

Rhino ランタイムの有効化

スクリプトで V8 を使用していて、元の Rhino ランタイムを使用するように切り替える必要がある場合、次の手順を実施します。

Apps Script プロジェクトを開きます。
左側にある [プロジェクトの設定] をクリックします。
[Chrome V8 ランタイムを有効にする] チェックボックスをオフにします。

または、スクリプトマニフェストを編集します。

Apps Script プロジェクトを開きます。
左側にある [プロジェクトの設定] をクリックします。
[「appsscript.json」マニフェストファイルをエディタで表示する] チェックボックスをオンにします。
左側にある [エディタ] > [appsscript.json] をクリックします。
appsscript.json マニフェストファイルで、runtimeVersion フィールドの値を DEPRECATED_ES5 に設定します。
上部にある [プロジェクトを保存] をクリックします。

既存のスクリプトを移行する方法

V8 へのスクリプトの移行ガイドでは、既存のスクリプトを V8 に移行するために必要な手順について説明しています。これには、V8 ランタイムを有効にし、スクリプトに既知の非互換性がないかどうかの確認が含まれます。

スクリプトの V8 への自動移行

2020 年 2 月 18 日より、Google の自動互換性テストに合格した既存のスクリプトを V8 に段階的に移行します。影響を受けるスクリプトは、移行後も引き続き通常どおり機能します。

スクリプトを自動移行からオプトアウトする場合は、マニフェストの runtimeVersion フィールドを DEPRECATED_ES5 に設定します。その後はいつでも、手動でスクリプトを V8 に移行できます。

バグを報告するにはどうすればよいですか？

サポートガイドでは、Stack Overflow でのプログラミングに関するサポートの利用方法、既存の問題レポートの検索方法、新しいバグの報告方法、新機能のリクエストを行う方法について説明しています。