Klasa google.script.url (interfejs API po stronie klienta)

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

MetodaZwracany typKró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

NazwaTypOpis
functionFunctionwywoł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 # lub pustego ciągu, jeśli nie ma fragmentu adresu URL.

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 location.parameter, ale z tablicą wartości dla każdego klucza. Jeśli nie ma parametrów, jest to pusty obiekt.

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