Class HtmlService

HtmlService

Servizio per restituire HTML e altri contenuti di testo da uno script.

Per motivi di sicurezza, gli script non possono restituire direttamente i contenuti a un browser. Deve invece eseguire la sanitizzazione del codice HTML in modo che non possa eseguire azioni dannose. Consulta la descrizione di HtmlOutput per conoscere le limitazioni relative a ciò che può essere restituito.

Proprietà

ProprietàTipoDescrizione
SandboxModeSandboxModeUn enum che rappresenta le modalità di sandbox che possono essere utilizzate per gli script HtmlService lato client.
XFrameOptionsModeXFrameOptionsModeUn enum che rappresenta le modalità X-Frame-Options che possono essere utilizzate per gli script HtmlService lato client.

Metodi

MetodoTipo restituitoBreve descrizione
createHtmlOutput()HtmlOutputCrea un nuovo oggetto HtmlOutput che può essere restituito dallo script.
createHtmlOutput(blob)HtmlOutputCrea un nuovo oggetto HtmlOutput da una risorsa BlobSource.
createHtmlOutput(html)HtmlOutputCrea un nuovo oggetto HtmlOutput che può essere restituito dallo script.
createHtmlOutputFromFile(filename)HtmlOutputCrea un nuovo oggetto HtmlOutput da un file nell'editor di codice.
createTemplate(blob)HtmlTemplateCrea un nuovo oggetto HtmlTemplate da una risorsa BlobSource.
createTemplate(html)HtmlTemplateCrea un nuovo oggetto HtmlTemplate che può essere restituito dallo script.
createTemplateFromFile(filename)HtmlTemplateCrea un nuovo oggetto HtmlTemplate da un file nell'editor di codice.
getUserAgent()StringRecupera la stringa user agent del browser corrente.

Documentazione dettagliata

createHtmlOutput()

Crea un nuovo oggetto HtmlOutput che può essere restituito dallo script. 

const output = HtmlService.createHtmlOutput();

Invio

HtmlOutput: il nuovo oggetto HtmlOutput

createHtmlOutput(blob)

Crea un nuovo oggetto HtmlOutput da una risorsa BlobSource. 

function createFromBlob(blob) {
  const output = HtmlService.createHtmlOutput(blob);
  return output;
}

Parametri

NomeTipoDescrizione
blobBlobSourceL'oggetto da cui estrarre il codice HTML

Invio

HtmlOutput: il nuovo oggetto HtmlOutput

Lanci

Error: se il blob non contiene HTML o se l'HTML è in un formato non corretto

createHtmlOutput(html)

Crea un nuovo oggetto HtmlOutput che può essere restituito dallo script. 

const output = HtmlService.createHtmlOutput('<b>Hello world!</b>');

Parametri

NomeTipoDescrizione
htmlStringi contenuti da pubblicare

Invio

HtmlOutput: il nuovo oggetto HtmlOutput

Lanci

Error: se il codice HTML non è corretto

createHtmlOutputFromFile(filename)

Crea un nuovo oggetto HtmlOutput da un file nell'editor di codice. 

const output = HtmlService.createHtmlOutputFromFile('myPage');

Parametri

NomeTipoDescrizione
filenameStringil nome del file da utilizzare

Invio

HtmlOutput: il nuovo oggetto HtmlOutput

Lanci

Error: se il file non è stato trovato o se il codice HTML al suo interno non è formattato correttamente

createTemplate(blob)

Crea un nuovo oggetto HtmlTemplate da una risorsa BlobSource. 

function createFromBlob(blob) {
  const template = HtmlService.createTemplate(blob);
  const output = template.evaluate();
  return output;
}

Parametri

NomeTipoDescrizione
blobBlobSourceL'oggetto da cui estrarre il codice HTML.

Invio

HtmlTemplate: il nuovo oggetto HtmlTemplate

Lanci

Error: se il blob non contiene HTML

createTemplate(html)

Crea un nuovo oggetto HtmlTemplate che può essere restituito dallo script. 

const template = HtmlService.createTemplate(
    '<b>The time is &lt;?= new Date() ?&gt;</b>',
);

Parametri

NomeTipoDescrizione
htmlStringI contenuti del modello

Invio

HtmlTemplate: il nuovo oggetto HtmlTemplate

createTemplateFromFile(filename)

Crea un nuovo oggetto HtmlTemplate da un file nell'editor di codice. 

const template = HtmlService.createTemplateFromFile('myTemplate');

Parametri

NomeTipoDescrizione
filenameStringil nome del file da utilizzare

Invio

HtmlTemplate: il nuovo oggetto HtmlTemplate

Lanci

Error: se il file non è stato trovato

getUserAgent()

Recupera la stringa user agent del browser corrente. Restituisce null per la maggior parte delle esecuzioni dello script se non viene utilizzato nella funzione doGet() o doPost() di un'app web.

Invio

String: la stringa dello user agent