google.script.url
: URL을 쿼리하여 현재 URL 매개변수와 프래그먼트를 가져올 수 있는 비동기 클라이언트 측 JavaScript API입니다.
이 API는 google.script.history
API를 지원합니다. IFRAME
를 사용하는 웹 앱의 컨텍스트에서만 사용할 수 있습니다.
부가기능 또는 container-script 컨텍스트의 사이드바 및 대화상자와 함께 사용하기 위한 것이 아닙니다. 자세한 내용은 웹 앱에서 브라우저 방문 기록을 사용하는 방법에 관한 가이드를 참고하세요.
방법
메서드 | 반환 유형 | 간략한 설명 |
---|---|---|
getLocation(function) |
void |
URL 위치 객체를 가져와 지정된 콜백 함수에 전달합니다. |
자세한 문서
getLocation(function)
URL 위치 객체를 가져와서 지정된 콜백 함수에 유일한 인수로 전달합니다.
Index.html
google.script.url.getLocation(function(location) { console.log(location.parameters); console.log(location.hash); });
매개변수
이름 | 유형 | 설명 |
---|---|---|
function | Function | 위치 객체를 유일한 인수로 사용하여 실행할 클라이언트 측 콜백 함수를 만듭니다. |
위치 객체
다음 표에는http://www.example.com?n=1&name=alice&n=2#headingAnchor
URL을 쿼리하면 지정되는 위치 요소의 예가 나와 있습니다.
필드 | |
---|---|
location.hash |
headingAnchor |
location.parameter |
URL 요청 매개변수에 해당하는 키-값 쌍의 객체입니다. 값이 여러 개인 매개변수의 경우 첫 번째 값만 반환됩니다. 매개변수가 없으면 빈 객체가 됩니다. {"name": "alice", "n": "1"} |
location.parameters |
{"name": ["alice"], "n": ["1", "2"]} |