google.script.url
— это асинхронный клиентский API JavaScript, который может запрашивать URL-адреса для получения текущих параметров и фрагмента URL-адреса. Этот API поддерживает API google.script.history
. Его можно использовать только в контексте веб-приложения, использующего IFRAME
. Он не предназначен для использования с боковыми панелями и диалоговыми окнами в контексте надстройки или сценария контейнера. Дополнительные сведения см. в руководстве по использованию истории браузера в веб-приложениях .
Методы
Метод | Тип возврата | Краткое описание |
---|---|---|
getLocation(function) | void | Получает объект местоположения URL-адреса и передает его указанной функции обратного вызова. |
Подробная документация
getLocation(function)
Получает объект местоположения URL-адреса и передает его указанной функции обратного вызова (в качестве единственного аргумента).
Индекс.html
google.script.url.getLocation(function(location) { console.log(location.parameters); console.log(location.hash); });
Параметры
Имя | Тип | Описание |
---|---|---|
function | Function | функция обратного вызова на стороне клиента для запуска, используя объект местоположения в качестве единственного аргумента. |
Объект местоположения
В следующей таблице показаны примеры элементов местоположения, которые будут указаны, если был запрошен следующий URL-адрес:http://www.example.com?n=1&name=alice&n=2#headingAnchor
Поля | |
---|---|
location.hash | Строковое значение фрагмента URL-адреса после символа headingAnchor |
location.parameter | Объект пар ключ/значение, соответствующий параметрам запроса URL. Для параметров, имеющих несколько значений, будет возвращено только первое значение. Если параметры отсутствуют, это будет пустой объект. {"name": "alice", "n": "1"} |
location.parameters | Объект, аналогичный {"name": ["alice"], "n": ["1", "2"]} |