google.script.url (用戶端 API) 類別

google.script.url 是非同步的用戶端 JavaScript API，可查詢網址來取得目前的網址參數和片段。這個 API 支援 google.script.history API。只能用於使用 IFRAME 的網頁應用程式。不適用於在外掛程式或容器指令碼內容中，與側欄和對話方塊搭配使用。詳情請參閱在網頁應用程式中使用瀏覽器歷史記錄的指南。

方法

方法	傳回類型	簡短說明
getLocation(function)	void	取得網址位置物件，並傳遞至指定的回呼函式。

內容詳盡的說明文件

getLocation(function)

取得網址位置物件，並傳遞至指定的回呼函式 (做為唯一的引數)。

Index.html

google.script.url.getLocation(function(location) {
  console.log(location.parameters);
  console.log(location.hash);
});

參數

名稱	類型	說明
function	Function	要執行的用戶端回呼函式，使用位置物件做為唯一的引數。

位置物件

下表舉例說明系統查詢以下網址時，可能會指定的位置元素：http://www.example.com?n=1&name=alice&n=2#headingAnchor

欄位
location.hash	# 字元後方的網址片段字串值，如果沒有任何網址片段，則傳回空白字串 headingAnchor
location.parameter	與網址要求參數相對應的鍵/值組合物件。如果參數有多個值，系統只會傳回第一個值。如果沒有參數，這個物件會是空白的物件。 {"name": "alice", "n": "1"}
location.parameters	與 location.parameter 類似的物件，但內含每個鍵的值陣列。如果沒有參數，這個物件會是空白的物件。 {"name": ["alice"], "n": ["1", "2"]}

---