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
Metodo | Tipo restituito | Breve 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
Nome | Tipo | Descrizione |
---|---|---|
function | Function | una 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 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 {"name": ["alice"], "n": ["1", "2"]} |