Документ взят из кэша поисковой машины. Адрес
оригинального документа
: http://www.arcetri.astro.it/irlab/doc/library/javascript/clientreference/history.htm
Дата изменения: Thu Oct 7 13:13:38 1999 Дата индексирования: Sat Dec 22 14:29:30 2007 Кодировка: Поисковые слова: п п п п п п п п п п |
JavaScript 1.1: added |
History
objects are predefined JavaScript objects that you access through the history
property of a window
object.
Location.replace
method. This replaces the current page with a new one without generating a history entry. See Location.replace
.
You can refer to the history
entries by using the window.history
array. This array contains an entry for each history entry in source order. Each array entry is a string containing a URL. For example, if the history list contains three named entries, these entries are reflected as history[0]
, history[1]
, and history[2]
.
If you access the history
array without specifying an array element, the browser returns a string of HTML which displays a table of URLs, each of which is a link.
Property |
Description
|
|
|
| |
---|
Method |
Description
|
|
| |
---|
watch
and unwatch
methods from Object
.
history.go(-3)Example 2. You can use the
history
object with a specific window or frame. The following example causes window2
to go back one item in its window (or session) history:
window2.history.back()Example 3. The following example causes the second frame in a frameset to go back one item:
parent.frames[1].history.back()Example 4. The following example causes the frame named
frame1
in a frameset to go back one item:
parent.frame1.history.back()Example 5. The following example causes the frame named
frame2
in window2
to go back one item:
window2.frame2.history.back()Example 6. The following code determines whether the first entry in the
history
array contains the string "NETSCAPE"
. If it does, the function myFunction
is called.
if (history[0].indexOf("NETSCAPE") != -1) {Example 7. The following example displays the entire history list:
myFunction(history[0])
}
document.writeln("<B>history is</B> " + history)This code displays output similar to the following:
history is
Welcome to Netscape http://home.netscape.com/
Sun Microsystems http://www.sun.com/
Royal Airways http://www.supernet.net/~dugbrown/
Location
, Location.replace
back()
back
method is the same as history.go(-1)
.
<P><INPUT TYPE="button" VALUE="< Go Back"
onClick="history.back()">
<P><INPUT TYPE="button" VALUE="> Go Back"
onClick="myWindow.back()">
History.forward
, History.go
UniversalBrowserRead
privilege. It has no value if you do not have this privilege. For information on security, see the Client-Side JavaScript Guide.
JavaScript 1.1.
This property is tainted by default. It has no value of data tainting is disabled. For information on data tainting, see the Client-Side JavaScript Guide.
history.current
contains the string "netscape.com"
. If it does, the function myFunction
is called.
if (history.current.indexOf("netscape.com") != -1) {
myFunction(history.current)
}
History.next
, History.previous
forward()
forward
method is the same as history.go(1)
.
<P><INPUT TYPE="button" VALUE="< Forward"
onClick="history.forward()">
<P><INPUT TYPE="button" VALUE="> Forward"
onClick="myWindow.forward()">
History.back
, History.go
go(delta)
go(location)
delta | An integer representing a relative position in the history list. |
location | A string representing all or part of a URL in the history list. |
go
method navigates to the location in the history list determined by the specified parameter.
If the delta
argument is 0, the browser reloads the current page. If it is an integer greater than 0, the go
method loads the URL that is that number of entries forward in the history list; otherwise, it loads the URL that is that number of entries backward in the history list.
The location
argument is a string. Use location
to load the nearest history entry whose URL contains location
as a substring. Matching the URL to the location
parameter is case-insensitive. Each section of a URL contains different information. See Location
for a description of the URL components.
The go
method creates a new entry in the history list. To load a URL without creating an entry in the history list, use Location.replace
.
"home.netscape.com"
:
<P><INPUT TYPE="button" VALUE="Go"The following button navigates to the URL that is three entries backward in the history list:
onClick="history.go('home.netscape.com')">
<P><INPUT TYPE="button" VALUE="Go"
onClick="history.go(-3)">
History.back
, History.forward
, Location.reload
, Location.replace
history
array. UniversalBrowserRead
privilege. For information on security, see the Client-Side JavaScript Guide.
UniversalBrowserRead
privilege. It has no value if you do not have this privilege. For information on security, see the Client-Side JavaScript Guide.
JavaScript 1.1.
This property is tainted by default. It has no value if data tainting is disabled. For information on data tainting, see the Client-Side JavaScript Guide.
next
property reflects the URL that would be used if the user chose Forward from the Go menu.
history.next
contains the string "NETSCAPE.COM"
. If it does, the function myFunction
is called.
if (history.next.indexOf("NETSCAPE.COM") != -1) {
myFunction(history.next)
}
History.current
, History.previous
UniversalBrowserRead
privilege. It has no value if you do not have this privilege. For information on security, see the Client-Side JavaScript Guide.
JavaScript 1.1.
This property is tainted by default. It has no value of data tainting is disabled. For information on data tainting, see the Client-Side JavaScript Guide.
previous
property reflects the URL that would be used if the user chose Back from the Go menu.
history.previous
contains the string "NETSCAPE.COM"
. If it does, the function myFunction
is called.
if (history.previous.indexOf("NETSCAPE.COM") != -1) {
myFunction(history.previous)
}
History.current
, History.next
Last Updated: 05/28/99 11:59:35