google.script.url 类（客户端 API）

google.script.url 是一个异步客户端 JavaScript API，可以查询网址以获取当前网址参数和片段。此 API 支持 google.script.history API。它只能在使用 IFRAME 的 Web 应用的上下文中使用。它不适用于插件或容器脚本上下文中的边栏和对话框。如需了解详情，请参阅有关在 Web 应用中使用浏览器历史记录的指南。

方法

方法返回类型简介
getLocation(function) void 获取网址位置对象并将其传递给指定的回调函数。

详细文档

getLocation(function)

获取网址位置对象并将其传递给指定的回调函数（作为唯一参数）。

Index.html

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

参数

名称类型说明
functionFunction要运行的客户端回调函数，使用位置对象作为唯一参数。

Location 对象

下表显示了在查询以下网址时要指定的位置元素示例：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"]}