In Apps Script e JavaScript, un runtime o ambiente di runtime contiene il motore JavaScript che analizza ed esegue il codice dello script. Il runtime fornisce regole per l'accesso alla memoria, per l'interazione del programma con il sistema operativo del computer e per la sintassi legale del programma. Ogni browser web ha un ambiente di runtime per JavaScript.
Storicamente, Apps Script è stato alimentato dall'interprete JavaScript Rhino di Mozilla. Sebbene Rhino offrisse un modo pratico per eseguire gli script degli sviluppatori in Apps Script, vincolava anche Apps Script a una versione specifica di JavaScript (ES5). Gli sviluppatori di Apps Script non possono utilizzare sintassi e funzionalità JavaScript più moderne negli script che utilizzano il runtime Rhino.
Per risolvere questo problema, Apps Script è ora supportato dal runtime V8 che alimenta Chrome e Node.js. Puoi eseguire la migrazione degli script esistenti a V8 per sfruttare la sintassi e le funzionalità JavaScript moderne.
Questa pagina descrive le nuove funzionalità abilitate da V8 e come puoi attivare V8 per l'utilizzo negli script. Esegui la migrazione degli script a V8 descrive i passaggi per eseguire la migrazione degli script esistenti in modo che utilizzino il runtime V8.
Funzionalità del runtime V8
Gli script che utilizzano il runtime V8 possono sfruttare le seguenti funzionalità:
Sintassi ECMAScript moderna
Puoi utilizzare la sintassi ECMAScript moderna negli script basati sul runtime V8. Questa sintassi include
let
, const
e molte altre funzionalità popolari.
Consulta Esempi di sintassi V8 per un breve elenco dei miglioramenti più comuni che puoi apportare alla sintassi utilizzando il runtime V8.
Rilevamento delle funzioni migliorato
Il rilevamento delle funzioni Apps Script è migliorato per gli script che utilizzano V8. Il nuovo runtime riconosce questi formati di definizione delle funzioni:
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 () => {}
Chiamare i metodi degli oggetti da trigger e callback
Gli script che utilizzano V8 possono chiamare metodi di oggetti e metodi statici di classi da posizioni in cui era già possibile chiamare metodi di librerie. Questi luoghi includono:
- Trigger manifest dei componenti aggiuntivi di Google Workspace
- Trigger installabili
- Voci di menu negli editor di Google Workspace
- Funzioni di callback dell'utente, come quella descritta nell'esempio di codice
ScriptApp.newStateToken()
.
Il seguente esempio di V8 mostra l'utilizzo dei metodi degli oggetti durante la creazione di voci di menu in Fogli Google:
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');
}
}
Visualizza i log
Apps Script fornisce due servizi di logging: il servizio Logger
e la classe console
. Entrambi questi servizi
scrivono i log nello stesso
servizio Stackdriver Logging.
Per visualizzare i log Logger
e console
, fai clic su
Log esecuzione nella parte superiore dell'editor di script.
Visualizza esecuzioni
Per visualizzare la cronologia di esecuzione dello script, apri il progetto Apps Script e fai clic su Esecuzioni
a sinistra.Esempi di sintassi V8
Di seguito è riportato un breve elenco di funzionalità sintattiche popolari disponibili per gli script che utilizzano il runtime V8.
let
e const
Le parole chiave let
e const
ti consentono di definire rispettivamente variabili locali e costanti
con ambito di blocco.
// 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 |
Funzioni freccia
Le funzioni freccia offrono un modo compatto per definire le funzioni all'interno delle espressioni.
// 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)); |
Corsi
Le classi forniscono un mezzo per organizzare concettualmente il codice con l'ereditarietà. Le classi in V8 sono principalmente zucchero sintattico rispetto all'ereditarietà basata su prototipi 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) |
Assegnazioni di destrutturazione
Le espressioni di assegnazione destrutturante sono un modo rapido per estrarre valori da array e oggetti in variabili distinte.
// 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 letterali
I template letterali sono stringhe letterali che consentono espressioni incorporate. Ti consentono di evitare istruzioni di concatenazione di stringhe più complesse.
// 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}`; |
Parametri predefiniti
I parametri predefiniti consentono di specificare i valori predefiniti per i parametri della funzione nella dichiarazione della funzione. In questo modo, il codice nel corpo della funzione viene semplificato perché non è più necessario assegnare esplicitamente valori predefiniti ai parametri mancanti.
// 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!" |
Stringhe multiriga
Puoi definire stringhe multilinea utilizzando la stessa sintassi dei template letterali. Come per i letterali modello, questa sintassi consente di evitare le concatenazioni di stringhe e semplificare le definizioni di stringhe.
// 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`; |
Attivazione del runtime V8
Se uno script utilizza il runtime Rhino, puoi passare a V8 nel seguente modo:
- Apri il progetto Apps Script.
- A sinistra, fai clic su Impostazioni progetto .
- Seleziona la casella di controllo Abilita il runtime Chrome V8.
In alternativa, puoi specificare l'ambiente di runtime dello script direttamente modificando il file manifest dello script:
- Apri il progetto Apps Script.
- A sinistra, fai clic su Impostazioni progetto .
- Seleziona la casella di controllo Mostra il file manifest "appsscript.json" nell'editor.
- A sinistra, fai clic su Editor
appsscript.json
.
>
- Nel file manifest
appsscript.json
, imposta il camporuntimeVersion
sul valoreV8
. - In alto, fai clic su Salva progetto .
La pagina Esegui la migrazione degli script a V8 spiega altri passaggi da seguire per assicurarti che lo script funzioni correttamente con V8.
Attivazione del runtime Rhino
Se il tuo script utilizza V8 e devi passare al runtime Rhino originale, segui questi passaggi:
- Apri il progetto Apps Script.
- A sinistra, fai clic su Impostazioni progetto .
- Deseleziona la casella di controllo Abilita il runtime Chrome V8.
In alternativa, modifica il manifest dello script:
- Apri il progetto Apps Script.
- A sinistra, fai clic su Impostazioni progetto .
- Seleziona la casella di controllo Mostra il file manifest "appsscript.json" nell'editor.
- A sinistra, fai clic su Editor
appsscript.json
.
>
- Nel file manifest
appsscript.json
, imposta il camporuntimeVersion
sul valoreDEPRECATED_ES5
. - In alto, fai clic su Salva progetto .
Come faccio a eseguire la migrazione degli script esistenti?
La guida Esegui la migrazione degli script a V8 descrive i passaggi da seguire per eseguire la migrazione di uno script esistente in modo che utilizzi V8. Ciò comporta l'attivazione del runtime V8 e il controllo dello script per eventuali incompatibilità note.
Migrazione automatica degli script a V8
A partire dal 18 febbraio 2020, Google inizierà la migrazione graduale degli script esistenti che superano il nostro test di compatibilità automatizzato a V8. Gli script interessati continuano a funzionare normalmente dopo la migrazione.
Se vuoi disattivare la migrazione automatica di uno script, imposta il campo
runtimeVersion
nel relativo manifest su DEPRECATED_ES5
. Puoi scegliere di eseguire la migrazione dello script a V8 manualmente in qualsiasi momento successivo.
Come faccio a segnalare i bug?
La guida all'assistenza spiega come ottenere aiuto per la programmazione su Stack Overflow, cercare segnalazioni di problemi esistenti, segnalare nuovi bug e presentare nuove richieste di funzionalità.