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); });
参数
名称 | 类型 | 说明 |
---|---|---|
function | Function | 要运行的客户端回调函数,使用位置对象作为唯一参数。 |
Location 对象
下表显示了在查询以下网址时要指定的位置元素示例:http://www.example.com?n=1&name=alice&n=2#headingAnchor
字段 | |
---|---|
location.hash |
网址片段的 headingAnchor |
location.parameter |
与网址请求参数对应的键值对对象。具有多个值的参数只会返回第一个值。如果不存在参数,则该对象为空对象。 {"name": "alice", "n": "1"} |
location.parameters |
一个类似于 {"name": ["alice"], "n": ["1", "2"]} |