google.script.url
, geçerli URL parametrelerini ve parçasını almak için URL'leri sorgulayabilen, eşzamansız bir istemci tarafı JavaScript API'sidir.
Bu API, google.script.history
API'yi destekler. Yalnızca IFRAME
kullanan bir web uygulaması bağlamında kullanılabilir.
Eklenti veya container komut dosyası bağlamında kenar çubukları ve iletişim kutularıyla kullanılmak üzere tasarlanmamıştır. Daha fazla bilgi için web uygulamalarında tarayıcı geçmişini kullanma kılavuzuna bakın.
Yöntemler
Yöntem | Dönüş türü | Kısa açıklama |
---|---|---|
getLocation(function) |
void |
Bir URL konum nesnesini alır ve belirtilen geri çağırma işlevine iletir. |
Ayrıntılı belgeler
getLocation(function)
Bir URL konum nesnesi alır ve bunu belirtilen geri çağırma işlevine iletir (tek bağımsız değişken olarak).
Index.html
google.script.url.getLocation(function(location) { console.log(location.parameters); console.log(location.hash); });
Parametreler
Ad | Tür | Açıklama |
---|---|---|
function | Function | tek bağımsız değişken olarak konum nesnesini kullanarak, bir istemci tarafı geri çağırma işlevi oluşturun. |
Konum nesnesi
Aşağıdaki tabloda, şu URL sorgulandığında belirtilecek konum öğelerine örnekler gösterilmektedir:http://www.example.com?n=1&name=alice&n=2#headingAnchor
Alanlar | |
---|---|
location.hash |
headingAnchor |
location.parameter |
URL istek parametrelerine karşılık gelen anahtar/değer çiftleri nesnesi. Birden çok değeri olan parametreler için yalnızca ilk değer döndürülür. Herhangi bir parametre yoksa bu boş bir nesne olur. {"name": "alice", "n": "1"} |
location.parameters |
{"name": ["alice"], "n": ["1", "2"]} |