V8 Çalışma Zamanına Genel Bakış

Apps Komut Dosyası ve JavaScript'te çalışma zamanı veya çalışma zamanı ortamı, komut dosyası kodunu ayrıştırıp yürüten JavaScript motorunu içerir. Çalışma zamanı, belleğe nasıl erişileceğine, programın bilgisayarın işletim sistemiyle nasıl etkileşime geçebileceğine ve hangi program söz dizesinin yasal olduğuna dair kurallar sağlar. Her web tarayıcısının JavaScript için bir çalışma ortamı vardır.

Apps Komut Dosyası, geçmişte Mozilla'nın Rhino JavaScript yorumlayıcısı tarafından destekleniyordu. Rhino, Apps Komut Dosyası'nın geliştirici komut dosyalarını yürütmesi için uygun bir yöntem sunarken Apps Komut Dosyası'nı belirli bir JavaScript sürümüne (ES5) de bağladı. Apps Komut Dosyası geliştiricileri, Rhino çalışma zamanını kullanan komut dosyalarında daha modern JavaScript söz dizimi ve özelliklerini kullanamaz.

Bu endişeyi gidermek için Apps Komut Dosyası artık Chrome ve Node.js'i destekleyen V8 çalışma zamanı tarafından desteklenmektedir. Modern JavaScript söz diziminde ve özelliklerinden yararlanmak için mevcut komut dosyalarını V8'e taşıyabilirsiniz.

Bu sayfada, V8'in etkinleştirdiği yeni özellikler ve V8'i komut dosyalarınızda kullanmak için nasıl etkinleştirebileceğiniz açıklanmaktadır. Komut dosyalarını V8'e taşıma bölümünde, mevcut komut dosyalarını V8 çalışma zamanını kullanacak şekilde taşımayla ilgili adımlar açıklanmaktadır.

V8 çalışma zamanının özellikleri

V8 çalışma zamanını kullanan komut dosyaları aşağıdaki özelliklerden yararlanabilir:

Modern ECMAScript söz dizimi

V8 çalışma zamanında desteklenen komut dosyalarında modern ECMAScript söz dizimini kullanabilirsiniz. Bu söz dizimi, let, const ve diğer birçok popüler özelliği içerir.

V8 çalışma zamanını kullanarak yapabileceğiniz popüler söz dizimi iyileştirmelerinin kısa bir listesi için V8 söz dizimi örnekleri bölümüne bakın.

İyileştirilmiş işlev algılama

Apps Komut Dosyası işlev algılama özelliği, V8 kullanan komut dosyaları için iyileştirildi. Yeni çalışma zamanı aşağıdaki işlev tanımı biçimlerini tanır:

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

Tetikleyicilerden ve geri aramalardan nesne yöntemlerini çağırma

V8 kullanan komut dosyaları, kitaplık yöntemlerini çağırabileceğiniz yerlerden nesne yöntemlerini ve sınıf statik yöntemlerini çağırabilir. Bu yerler şunlardır:

• Google Workspace eklentileri manifest tetikleyicileri
• Yüklenebilir tetikleyiciler
• Düzenleyicilerdeki Google Workspace menü öğeleri
• ScriptApp.newStateToken() kod örneğinde açıklanan kullanıcı geri çağırma işlevleri.

Aşağıdaki V8 örneğinde, Google E-Tablolar'da menü öğeleri oluştururken nesne yöntemlerinin kullanımı gösterilmektedir:

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

Günlükleri göster

Apps Script iki günlük kaydı hizmeti sunar: Logger hizmeti ve console sınıfı. Bu hizmetlerin her ikisi de günlükleri aynı Stackdriver Logging hizmetine yazar.

Logger ve console günlüklerini göstermek için komut dosyası düzenleyicisinin üst kısmındaki Yürütme günlüğü'nü tıklayın.

Yürütmeleri görüntüleme

Komut dosyanızın yürütme geçmişini görüntülemek için Apps Komut Dosyası projesini açın ve solda Yürütmeler'i playlist_play tıklayın.

V8 söz dizimi örnekleri

Aşağıda, V8 çalışma zamanını kullanan komut dosyalarında kullanılabilen popüler söz dizimi özelliklerinin kısa bir listesi verilmiştir.

let ve const

let ve const anahtar kelimeleri, sırasıyla blok kapsamlı yerel değişkenleri ve blok kapsamlı sabitleri tanımlamanıza olanak tanır.

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

Ok işlevleri

Ok işlevleri, ifadelerde işlevleri tanımlamanın kompakt bir yolunu sunar.

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

Sınıflar

Sınıflar, kodları kalıtımla kavramsal olarak düzenlemenin bir yolunu sağlar. V8'deki sınıflar, temel olarak JavaScript prototip tabanlı devralma üzerinde söz dizimi süslemesi olarak kullanılır.

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

Atamaların yapısını bozma

Yapı bozma atama ifadeleri, dizilerdeki ve nesnelerdeki değerleri farklı değişkenlerde paketlemenin hızlı bir yoludur.

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


      

Şablon literalleri

Şablon değişmezleri, yerleştirilmiş ifadelere izin veren dize değişmezleridir. Daha karmaşık dize birleştirme ifadelerinden kaçınmanıza olanak tanır.

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


      

Varsayılan parametreler

Varsayılan parametreler, işlev tanımında işlev parametreleri için varsayılan değerler belirtmenize olanak tanır. Bu, eksik parametrelere açıkça varsayılan değerler atamanın gerekliliğini ortadan kaldırdığından işlev gövdesinde kodu basitleştirebilir.

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

      

Çok satırlı dizeler

Şablon literalleri ile aynı söz dizimini kullanarak çoklu satırdan oluşan dize tanımlayabilirsiniz. Şablon literallerinde olduğu gibi bu söz dizimi, dize birleştirme işlemlerinden kaçınmanıza ve dize tanımlarını basitleştirmenize olanak tanır.

// 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 çalışma zamanını etkinleştirme

Bir komut dosyası Rhino çalışma zamanını kullanıyorsa aşağıdakileri yaparak V8'e geçirebilirsiniz:

1. Apps Komut Dosyası projesini açın.
2. Sol tarafta Proje Ayarları'nı settings tıklayın.
3. Chrome V8 çalışma zamanını etkinleştir onay kutusunu işaretleyin.

Alternatif olarak, komut dosyası çalışma zamanını doğrudan komut dosyası manifest dosyasını düzenleyerek belirtebilirsiniz:

1. Apps Komut Dosyası projesini açın.
2. Sol tarafta Proje Ayarları'nı settings tıklayın.
3. "appsscript.json" manifest dosyasını düzenleyicide göster onay kutusunu işaretleyin.
4. Sol tarafta, Düzenleyici code > appsscript.json'ı tıklayın.
5. appsscript.json manifest dosyasında runtimeVersion alanını V8 değerine ayarlayın.
6. Üstte Projeyi kaydet'i save tıklayın.

Komut dosyalarını V8'e taşıma başlıklı makalede, komut dosyanızın V8'i kullanarak düzgün şekilde çalışması için uygulamanız gereken diğer adımlar açıklanmaktadır.

Rhino çalışma zamanını etkinleştirme

Komut dosyanızda V8 kullanılıyorsa ve orijinal Rhino çalışma zamanını kullanacak şekilde değiştirmeniz gerekiyorsa aşağıdakileri yapın:

1. Apps Komut Dosyası projesini açın.
2. Sol tarafta Proje Ayarları'nı settings tıklayın.
3. Chrome V8 çalışma zamanını etkinleştir onay kutusunun işaretini kaldırın.

Alternatif olarak komut dosyası manifestinizi düzenleyin:

1. Apps Komut Dosyası projesini açın.
2. Sol tarafta Proje Ayarları'nı settings tıklayın.
3. "appsscript.json" manifest dosyasını düzenleyicide göster onay kutusunu işaretleyin.
4. Sol tarafta, Düzenleyici code > appsscript.json'ı tıklayın.
5. appsscript.json manifest dosyasında runtimeVersion alanını DEPRECATED_ES5 değerine ayarlayın.
6. Üstte Projeyi kaydet'i save tıklayın.

Mevcut komut dosyalarını nasıl taşıyabilirim?

Komut dosyalarını V8'e taşıma kılavuzunda, mevcut bir komut dosyasını V8'e taşımak için uygulamanız gereken adımlar açıklanmaktadır. Bu işlem, V8 çalışma zamanını etkinleştirmeyi ve komut dosyasında bilinen uyumsuzluk olup olmadığını kontrol etmeyi içerir.

Komut dosyalarının V8'e otomatik olarak taşınması

Google, 18 Şubat 2020'den itibaren otomatik uyumluluk testimizi geçen mevcut komut dosyalarını kademeli olarak V8'e taşımaya başlayacaktır. Etkilenen komut dosyaları, taşıma işleminden sonra normal şekilde çalışmaya devam eder.

Bir komut dosyasını otomatik taşıma kapsamı dışında bırakmak istiyorsanız manifest dosyasında runtimeVersion alanını DEPRECATED_ES5 olarak ayarlayın. Daha sonra dilediğiniz zaman komut dosyasını V8'e taşımayı manuel olarak seçebilirsiniz.

Hataları nasıl bildirebilirim?

Destek kılavuzunda, Stack Overflow'da programlama yardımı alma, mevcut sorun raporlarını arama, yeni hata bildirme ve yeni özellik isteği gönderme hakkında bilgi verilmektedir.