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"]}