Class google.script.url (API sisi klien)

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

MetodeJenis hasil yang ditampilkanDeskripsi 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

NamaJenisDeskripsi
functionFunctionfungsi 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 #, atau string kosong jika tidak ada fragmen URL

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 location.parameter, tetapi dengan array nilai untuk setiap kunci. Jika tidak ada parameter, objek ini akan kosong.

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