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à	Tipo	Descrizione
SandboxMode	SandboxMode	Un enum che rappresenta le modalità di sandbox che possono essere utilizzate per gli script HtmlService lato client.
XFrameOptionsMode	XFrameOptionsMode	Un enum che rappresenta le modalità X-Frame-Options che possono essere utilizzate per gli script HtmlService lato client.

Metodi

Metodo	Tipo restituito	Breve descrizione
createHtmlOutput()	HtmlOutput	Crea un nuovo oggetto HtmlOutput che può essere restituito dallo script.
createHtmlOutput(blob)	HtmlOutput	Crea un nuovo oggetto HtmlOutput da una risorsa BlobSource.
createHtmlOutput(html)	HtmlOutput	Crea un nuovo oggetto HtmlOutput che può essere restituito dallo script.
createHtmlOutputFromFile(filename)	HtmlOutput	Crea un nuovo oggetto HtmlOutput da un file nell'editor di codice.
createTemplate(blob)	HtmlTemplate	Crea un nuovo oggetto HtmlTemplate da una risorsa BlobSource.
createTemplate(html)	HtmlTemplate	Crea un nuovo oggetto HtmlTemplate che può essere restituito dallo script.
createTemplateFromFile(filename)	HtmlTemplate	Crea un nuovo oggetto HtmlTemplate da un file nell'editor di codice.
getUserAgent()	String	Recupera 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

Nome	Tipo	Descrizione
blob	BlobSource	L'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

Nome	Tipo	Descrizione
html	String	i 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

Nome	Tipo	Descrizione
filename	String	il 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

Nome	Tipo	Descrizione
blob	BlobSource	L'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

Nome	Tipo	Descrizione
html	String	I 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

Nome	Tipo	Descrizione
filename	String	il 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