Class google.script.url (API sisi klien)

google.script.url adalah JavaScript sisi klien asinkron API yang dapat mengkueri URL untuk mendapatkan fragmen dan parameter URL saat ini. API ini mendukung google.script.history Compute Engine API. Model ini hanya dapat digunakan dalam konteks aplikasi web yang menggunakan IFRAME Aplikasi ini tidak ditujukan untuk digunakan dengan bilah sisi dan dialog dalam add-on atau konteks container-script. Untuk informasi selengkapnya, lihat panduan untuk menggunakan browser histori di aplikasi web.

Metode

MetodeJenis hasil yang ditampilkanDeskripsi singkat
getLocation(function) void Mendapatkan objek lokasi URL dan meneruskannya ke callback yang ditentukan .

Dokumentasi mendetail

getLocation(function)

Mendapatkan objek lokasi URL dan meneruskannya ke 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
functionFunctionsisi klien fungsi callback yang akan dijalankan, dengan menggunakan location object sebagai satu-satunya argumen.

Objek lokasi

Tabel berikut menunjukkan contoh elemen lokasi yang akan ditentukan jika elemen URL berikut telah 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 permintaan URL parameter. Hanya nilai pertama yang akan ditampilkan untuk parameter yang memiliki beberapa nilai. Jika tidak ada parameter, menjadi objek kosong.

{"name": "alice", "n": "1"}
location.parameters

Objek yang mirip dengan location.parameter, tetapi dengan array nilai untuk setiap kunci. Jika tidak ada parameter, menjadi objek kosong.

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