本頁面由 Cloud Translation API 翻譯而成。

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

google.script.url 是非同步用戶端 JavaScript 可以查詢網址的 API，取得目前的網址參數和片段。這個 API 支援 google.script.history 也能使用 Google Cloud CLI 或 Compute Engine 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`	用戶端要執行的回呼函式 location object 做為唯一的引數。

位置物件

下表列舉了在查詢的網址：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"]}

location.hash

# 字元後方的網址片段字串值。如果沒有網址片段，則傳回空白字串

headingAnchor

location.parameter

與網址要求相對應的鍵/值組合物件參數。參數只會傳回第一個值顯示多個值如果沒有參數，這個不得為空物件

{"name": "alice", "n": "1"}

location.parameters

與 location.parameter 類似的物件，但各鍵的值陣列。如果沒有參數，這個不得為空物件

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