Classe google.script.url (API lato client)

google.script.url è un'API JavaScript lato client asincrona che può eseguire query sugli URL per ottenere i parametri e il frammento URL correnti. Questa API supporta l'API google.script.history. Può essere utilizzata solo nel contesto di un'app web che utilizza IFRAME. Non è destinato all'utilizzo con le barre laterali e le finestre di dialogo in un contesto di componenti aggiuntivi o container-script. Per maggiori informazioni, consulta la guida all'utilizzo della cronologia del browser nelle app web.

Metodi

MetodoTipo restituitoBreve descrizione
getLocation(function) void Ottieni un oggetto posizione URL e lo passa alla funzione di callback specificata.

Documentazione dettagliata

getLocation(function)

Restituisce un oggetto URL location e lo passa alla funzione di callback specificata (come unico argomento).

Index.html

google.script.url.getLocation(function(location) {
  console.log(location.parameters);
  console.log(location.hash);
});

Parametri

NomeTipoDescrizione
functionFunctionuna funzione di callback lato client da eseguire, utilizzando l'oggetto location come unico argomento.

Oggetto posizione

La tabella seguente mostra esempi degli elementi della posizione che verrebbero specificati se venisse eseguita una query sul seguente URL: http://www.example.com?n=1&name=alice&n=2#headingAnchor
Campi
location.hash

Il valore stringa del frammento di URL dopo il carattere # oppure una stringa vuota se non è presente alcun frammento di URL

headingAnchor
location.parameter

Un oggetto di coppie chiave/valore che corrispondono ai parametri di richiesta dell'URL. Per i parametri che hanno più valori, verrà restituito solo il primo valore. Se non sono presenti parametri, l'oggetto sarà vuoto.

{"name": "alice", "n": "1"}
location.parameters

Un oggetto simile a location.parameter, ma con un array di valori per ogni chiave. Se non sono presenti parametri, l'oggetto sarà vuoto.

{"name": ["alice"], "n": ["1", "2"]}