Class google.script.url (API sisi klien)
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
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
| Metode | Jenis hasil yang ditampilkan | Deskripsi 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
| Nama | Jenis | Deskripsi |
function | Function | sisi 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"]}
|
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-07-26 UTC.
[null,null,["Terakhir diperbarui pada 2025-07-26 UTC."],[[["\u003cp\u003e\u003ccode\u003egoogle.script.url\u003c/code\u003e is a client-side JavaScript API for querying URLs to get parameters and fragments within web apps.\u003c/p\u003e\n"],["\u003cp\u003eThis API works with \u003ccode\u003egoogle.script.history\u003c/code\u003e and requires the use of \u003ccode\u003eIFRAME\u003c/code\u003e in your web app.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003egetLocation()\u003c/code\u003e method retrieves a URL location object containing parameters and hash information, passing it to a callback function.\u003c/p\u003e\n"],["\u003cp\u003eThe location object provides access to URL components like hash, individual parameters, and all parameter values.\u003c/p\u003e\n"]]],[],null,["# Class google.script.url (Client-side API)\n\n`google.script.url` is an asynchronous client-side JavaScript\nAPI that can query URLs to obtain the current URL parameters and fragment.\nThis API supports the [`google.script.history`](/apps-script/guides/html/reference/history)\nAPI. It can only be used in the context of a web app that uses\n[`IFRAME`](/apps-script/reference/html/sandbox-mode#properties).\nIt is not intended for use with sidebars and dialogs in an add-on or\ncontainer-script context. For more information, see the\n[guide to using browser\nhistory in web apps](/apps-script/guides/web#web_apps_and_browser_history). \n\n### Methods\n\n| Method | Return type | Brief description |\n|-------------------------------------------------|-------------|------------------------------------------------------------------------------|\n| [getLocation(function)](#getLocation(Function)) | `void` | Gets a URL location object and passes it to the specified callback function. |\n\nDetailed documentation\n----------------------\n\n### `getLocation(function)`\n\nGets a [URL location object](#locationObject) and passes it to the specified callback\nfunction (as the only argument). \n\n### Index.html\n\n```html\ngoogle.script.url.getLocation(function(location) {\n console.log(location.parameters);\n console.log(location.hash);\n});\n```\n\n#### Parameters\n\n| Name | Type | Description |\n|------------|------------|------------------------------------------------------------------------------------------------------------|\n| `function` | `Function` | a client-side callback function to run, using the [location object](#locationObject) as the only argument. |\n\n#### Location object\n\nThe following table shows examples of the location elements that would be specified if the following URL was queried: `http://www.example.com?n=1&name=alice&n=2#headingAnchor`\n\n| Fields ||\n|-----------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `location.hash` | The string value of URL fragment after the `#` character, or an empty string if no URL fragment is present ``` headingAnchor ``` |\n| `location.parameter` | An object of key/value pairs that correspond to the URL request parameters. Only the first value will be returned for parameters that have multiple values. If no parameters are present, this will be an empty object. ``` {\"name\": \"alice\", \"n\": \"1\"} ``` |\n| `location.parameters` | An object similar to `location.parameter`, but with an array of values for each key. If no parameters are present, this will be an empty object. ``` {\"name\": [\"alice\"], \"n\": [\"1\", \"2\"]} ``` |\n\n*** ** * ** ***"]]
