History

현재 번역은 완벽하지 않습니다. 한국어로 문서 번역에 동참해주세요.

History 인터페이스는 브라우저의 세션 히스토리를 조작할 수 있게 합니다. 세션 히스토리에는 탭에서 방문했던 페이지들이나, 현재 페이지가 로딩된 프레임들이 포함됩니다.

Properties

History 인터페이스는 어떤 속성도 상속받지 않습니다.

History.length Read only
세션히스토리의 현재 로딩된 페이지를 포함한 요소 숫자들을 (정수 값) 반환합니다. 예를 들면, 새로운 탭의 로딩된 페이지는 1을 반환합니다.
History.current Read only 안씀 Gecko 26
세션히스토리의 활성화된 아이템의 URL을 반환합니다. 이 속성은 웹 콘텐츠에서 사용할 수 없고, 더이상 어떤 브라우저도 지원하지 않습니다. 대신에 Location.href를 활용하세요.
History.next Read only 안씀 Gecko 26
세션히스토리의 다음 아이템의 URL을 반환합니다. 이 속성은 웹 콘텐츠에서 사용할 수 없고, 더이상 어떤 브라우저도 지원하지 않습니다.
History.previous Read only 안씀 Gecko 26
세션히스토리의 이전 아이템의 URL을 반환합니다. 이 속성은 웹 콘텐츠에서 사용할 수 없고, 더이상 어떤 브라우저도 지원하지 않습니다.
History.scrollRestoration 
웹 어플리케이션에서 히스토리 네비게이션의 default 스크롤 복원 기능을 명시적으로 선언합니다.이 속성은 자동 또는 수동이 가능합니다.
History.state Read only
히스토리 스택의 가장 상위에 있는 상태 값을 반환합니다. popstate 이벤트 콜없이 바로 상태를 볼 수 있는 방법입니다.

Methods

History 인터페이스는 어떤 메서드도 상속받지 않습니다.

History.back()
세션히스토리의 이전 페이지로 갑니다. 브라우저 백 버튼을 눌렀을 때와 똑같은 효과, history.go(-1) 와 동등한 기능을 수행합니다.
Calling this method to go back beyond the first page in the session history has no effect and doesn't raise an exception.
History.forward()
세션히스토리의 다음페이지로 갑니다. 브라우저의 앞으로가기 버튼을 눌렀을 때와 같은 효과, history.go(1)와 동등한 기능 수행합니다.
Calling this method to go forward beyond the most recent page in the session history has no effect and doesn't raise an exception.
History.go()
세션히스토리의 특정 페이지를 로딩합니다, 현재 페이지의 상대적인 위치에 따라 페이지 순서가 정의됩니다. 예를 들어, -1은 이전 페이지, 1은 다음 페이지 입니다. 만약 out-of-bound 값을 지정한다면 (예를 들어, 세션 히스토리의 이전 방문 페이지가 없을 경우의 -1), 이 메서드는 아무 기능도 하지 않습니다. 변수 값을 넘기지 않거나, 0의 값을 가진 go() 메서드는 현재 페이지를 재로딩합니다.​​​​​​​
Internet Explorer lets you specify a string to go to a specific page in the history list; you should avoid this feature because it is non-standard.
History.pushState()
이 메서드는 지정한 타이틀과 URL을 세션 히스토리 스택에 밀어 넣습니다. 만약 데이터가 DOM에 의해 opaque로 간주된다면, 사용자는 동기화를 위한 javascript 객체를 지정해야 합니다. Firefox는 이 title 변수를 무시하고 있는 것을 참고하세요. 더 많은 정보를 위해서는 이 문서를 참조바랍니다. manipulating the browser history.
History.replaceState()
특정 데이터, 제목 및 URL을 히스토리 스택에서 가장 최신 엔트리로 수정합니다. 만약 데이터가 DOM에 의해 opaque로 간주된다면, 사용자는 동기화를 위한 javascript 객체를 지정해야 합니다. Firefox는 이 title 변수를 무시하고 있는 것을 참고하세요. 더 많은 정보를 위해서는 이 문서를 참조바랍니다. manipulating the browser history.

Specifications

Specification Status Comment
WHATWG HTML Living Standard
The definition of 'History' in that specification.
Living Standard Adds the scrollRestoration attribute.
HTML5
The definition of 'History' in that specification.
Recommendation Initial definition.
Custom Scroll Restoration - History-based API
The definition of 'History' in that specification.
Editor's Draft Adds the scrollRestoration attribute.

Browser compatibility

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
Basic support (Yes) (Yes) (Yes) (Yes) (Yes)
pushState and replaceState 5.0 4.0 [1] 10 11.5 5
scrollRestoration 46.0 46.0 (46.0) No support 33 No support
Feature Android Android Webview Firefox Mobile (Gecko) IE Phone Opera Mobile Safari Mobile Chrome for Android
Basic support (Yes) (Yes) (Yes) (Yes) (Yes) (Yes) (Yes)
pushState and replaceState 2.2 (Yes) (Yes) 10 (Yes) 4.3 (Yes)
scrollRestoration No support 46.0 (Yes) No support (Yes) No support 46.0

[1] In Firefox 2 through 5, the passed object is serialized using JSON. Starting in Firefox 6, the object is serialized using the structured clone algorithm. This allows a wider variety of objects to be safely passed.

See also

  • The Window.history property returning the history of the current session.

문서 태그 및 공헌자

 이 페이지의 공헌자: joshua1988
 최종 변경: joshua1988,