Location
Location
인터페이스는 객체가 연결된 장소(URL)를 표현합니다. Location
인터페이스에 변경을 가하면 연결된 객체에도 반영되는데, Document
와 Window
인터페이스가 이런 Location
을 가지고 있습니다. 각각 Document.location
과 Window.location
으로 접근할 수 있습니다.
속성
Location
인터페이스는 아무 속성도 상속하지 않지만, URLUtils
의 속성을 구현합니다.
Location.href
-
온전한 URL을 값으로 하는
DOMString
입니다. 바뀔 경우 연결된 문서도 새로운 페이지로 이동합니다. 연결된 문서와 다른 오리진에서도 설정할 수 있습니다. Location.protocol
-
URL의 프로토콜 부분을 값으로 하는
DOMString
으로, 마지막의':'
도 포함합니다. Location.host
-
URL의 호스트 부분을 값으로 하는
DOMString
으로, 호스트명,':'
, 포트 번호를 포함합니다. Location.hostname
-
URL의 도메인 부분을 값으로 하는
DOMString
입니다. Location.port
-
URL의 포트 번호를 값으로 하는
DOMString
입니다. Location.pathname
-
'/'
문자 뒤 URL의 경로를 값으로 하는DOMString
입니다. Location.search
-
'?'
문자 뒤 URL의 쿼리스트링을 값으로 하는DOMString
입니다. 모던 브라우저에서는URLSearchParams.get()
과URL.searchParams
를 사용해서 인자를 쉽게 추출할 수 있습니다. Location.hash
-
'#'
문자 뒤 URL의 프래그먼트 식별자를 값으로 하는DOMString
입니다. Location.username
-
도메인 이름 이전에 명시된 사용자명을 값으로 하는
DOMString
입니다. Location.password
-
도메인 이름 이전에 명시된 비밀번호를 값으로 하는
DOMString
입니다. Location.origin
읽기 전용-
지정한 장소 오리진의 표준 형태를 값으로 하는
DOMString
입니다.
메서드
Location
인터페이스는 아무 메서드도 상속하지 않지만, URLUtils
의 메서드를 구현합니다.
Location.assign()
-
주어진 URL의 리소스를 불러옵니다.
Location.reload()
-
현재 URL의 리소스를 다시 불러옵니다. 선택적으로 매개변수에
true
를 제공해 브라우저 캐시를 무시하고 서버에서 새로 불러올 수 있습니다, Location.replace()
-
Replaces the current resource with the one at the provided URL. The difference from the
assign()
method is that after usingreplace()
the current page will not be saved in sessionHistory
, meaning the user won't be able to use the back button to navigate to it. Location.toString()
-
Returns a
DOMString
containing the whole URL. It is a synonym forURLUtils.href
, though it can't be used to modify the value.
예제
// Create anchor element and use href property for the purpose of this example
// A more correct alternative is to browse to the URL and use document.location or window.location
var url = document.createElement("a");
url.href =
"https://developer.mozilla.org:8080/en-US/search?q=URL#search-results-close-container";
console.log(url.href); // https://developer.mozilla.org:8080/en-US/search?q=URL#search-results-close-container
console.log(url.protocol); // https:
console.log(url.host); // developer.mozilla.org:8080
console.log(url.hostname); // developer.mozilla.org
console.log(url.port); // 8080
console.log(url.pathname); // /en-US/search
console.log(url.search); // ?q=URL
console.log(url.hash); // #search-results-close-container
console.log(url.origin); // https://developer.mozilla.org:8080
명세
Specification |
---|
HTML Standard # the-location-interface |
브라우저 호환성
BCD tables only load in the browser
같이 보기
- Two methods creating such an object:
Window.location
andDocument.location
. - URL related interfaces:
URL
,URLSearchParams
andHTMLHyperlinkElementUtils