google.script.url
adalah JavaScript API sisi klien asinkron
yang dapat mengkueri URL untuk mendapatkan fragmen dan parameter URL saat ini.
API ini mendukung google.script.history
API. Kunci ini hanya dapat digunakan dalam konteks aplikasi web yang menggunakan
IFRAME
.
Alat ini tidak dimaksudkan untuk digunakan dengan sidebar dan dialog dalam konteks add-on atau
skrip container. Untuk mengetahui informasi selengkapnya, lihat
panduan menggunakan histori
browser pada aplikasi web.
Metode
Metode | Jenis hasil yang ditampilkan | Deskripsi singkat |
---|---|---|
getLocation(function) |
void |
Mengambil objek lokasi URL dan meneruskannya ke fungsi callback yang ditentukan. |
Dokumentasi mendetail
getLocation(function)
Mengambil objek lokasi URL dan meneruskannya ke fungsi callback yang ditentukan (sebagai satu-satunya argumen).
Index.html
google.script.url.getLocation(function(location) { console.log(location.parameters); console.log(location.hash); });
Parameter
Nama | Jenis | Deskripsi |
---|---|---|
function | Function | fungsi callback sisi klien untuk dijalankan, menggunakan objek lokasi sebagai satu-satunya argumen. |
Objek lokasi
Tabel berikut menampilkan contoh elemen lokasi yang akan ditentukan jika URL berikut dikueri:http://www.example.com?n=1&name=alice&n=2#headingAnchor
Kolom | |
---|---|
location.hash |
Nilai string fragmen URL setelah karakter headingAnchor |
location.parameter |
Objek key-value pair yang sesuai dengan parameter permintaan URL. Hanya nilai pertama yang akan ditampilkan untuk parameter yang memiliki beberapa nilai. Jika tidak ada parameter, objek ini akan kosong. {"name": "alice", "n": "1"} |
location.parameters |
Objek yang mirip dengan {"name": ["alice"], "n": ["1", "2"]} |