google.script.url
to asynchroniczny interfejs API JavaScript działający po stronie klienta, który może wysyłać zapytania do adresów URL w celu uzyskania bieżących parametrów i fragmentu adresu URL.
Ten interfejs API obsługuje google.script.history
API. Można go używać tylko w kontekście aplikacji internetowej korzystającej z metody IFRAME
.
Nie należy jej używać z paskami bocznymi i oknami w kontekście dodatku ani container-script. Więcej informacji znajdziesz w przewodniku po używaniu historii przeglądania w aplikacjach internetowych.
Metody
Metoda | Zwracany typ | Krótki opis |
---|---|---|
getLocation(function) |
void |
Pobiera obiekt lokalizacji adresu URL i przekazuje go do określonej funkcji wywołania zwrotnego. |
Szczegółowa dokumentacja
getLocation(function)
Pobiera obiekt URL lokalizacji i przekazuje go do określonej funkcji wywołania zwrotnego (jako jedyny argument).
Index.html
google.script.url.getLocation(function(location) { console.log(location.parameters); console.log(location.hash); });
Parametry
Nazwa | Typ | Opis |
---|---|---|
function | Function | wywołania zwrotnego po stronie klienta, używając obiektu lokalizacji jako jedynego argumentu. |
Obiekt lokalizacji
W tabeli poniżej znajdziesz przykłady elementów lokalizacji, które zostałyby określone, gdyby zapytanie zostało zrealizowane za pomocą tego adresu URL:http://www.example.com?n=1&name=alice&n=2#headingAnchor
Pola | |
---|---|
location.hash |
Wartość ciągu znaków fragmentu adresu URL po znaku headingAnchor |
location.parameter |
Obiekt par klucz/wartość odpowiadający parametrom żądania adresu URL. W przypadku parametrów, które mają wiele wartości, zostanie zwrócona tylko pierwsza wartość. Jeśli nie ma parametrów, jest to pusty obiekt. {"name": "alice", "n": "1"} |
location.parameters |
Obiekt podobny do {"name": ["alice"], "n": ["1", "2"]} |