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