Location
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
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