google.script.url
é uma API JavaScript assíncrona do lado do cliente que pode consultar URLs para receber os parâmetros e o fragmento de URL atuais.
Essa API é compatível com a API
google.script.history
. Ele só pode ser usado no contexto de um app da Web que usa
IFRAME
.
Ele não é indicado para uso com barras laterais e caixas de diálogo em um contexto de complemento ou
container-script. Para mais informações, consulte o guia para usar o histórico de navegação em apps da Web.
Métodos
Método | Tipo de retorno | Breve descrição |
---|---|---|
getLocation(function) |
void |
Recebe um objeto de localização do URL e o transmite para a função de callback especificada. |
Documentação detalhada
getLocation(function)
Recebe um objeto de localização do URL e o transmite para a função de callback especificada (como o único argumento).
Index.html
google.script.url.getLocation(function(location) { console.log(location.parameters); console.log(location.hash); });
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
function | Function | Uma função de callback do lado do cliente para ser executada usando o objeto de local como o único argumento. |
Objeto de localização
A tabela a seguir mostra exemplos dos elementos de local que seriam especificados se o seguinte URL fosse consultado:http://www.example.com?n=1&name=alice&n=2#headingAnchor
Campos | |
---|---|
location.hash |
O valor da string do fragmento de URL após o caractere headingAnchor |
location.parameter |
Um objeto de pares de chave-valor que correspondem aos parâmetros de solicitação de URL. Somente o primeiro valor será retornado para parâmetros que tenham vários valores. Se nenhum parâmetro estiver presente, o objeto estará vazio. {"name": "alice", "n": "1"} |
location.parameters |
Um objeto semelhante a {"name": ["alice"], "n": ["1", "2"]} |