JavaScript手册 
目录
此参考中包含
的内容
轻松上手
简介
操作符
语句
核心
文档
窗口
表单
浏览器
事件和
事件句柄
LiveWire
数据库服务
进程管理服务
实用工具
全局函数
LiveConnect
的Java包
索引
版权
 
【目录】 【上一页】 【下一页】 【索引】

History

Contains an array of information on the URLs that the client has visited within a window. This information is stored in a history list and is accessible through the browser's Go menu.

客户端对象
实现版本 Navigator 2.0
Navigator 3.0: 添加了 current, next, and previous properties;

创建源

History objects are predefined JavaScript objects that you access through the history property of a Window object.

描述

To change a window's current URL without generating a history entry, you can use the 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 表 of URLs, each of which is a link.

属性概览

current Specifies the URL of the current history entry.
length Reflects the number of entries in the history list.
next Specifies the URL of the next history entry.
previous Specifies the URL of the previous history entry.

方法概览

back Loads the previous URL in the history list.
forward Loads the next URL in the history list.
go Loads a URL from the history list.

示例

示例 1. The following example goes to the URL the user visited three clicks ago in the current window.

history.go(-3) 示例 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() 示例 3. The following example causes the second frame in a frameset to go back one item:

parent.frames[1].history.back() 示例 4. The following example causes the frame named frame1 in a frameset to go back one item:

parent.frame1.history.back() 示例 5. The following example causes the frame named frame2 in window2 to go back one item:

window2.frame2.history.back() 示例 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) {
   myFunction(history[0])
}
示例 7. The following example displays the entire history list:

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

属性

current

A string specifying the complete URL of the current history entry.

属性源 History
只读
实现版本 Navigator 3.0

安全性

Navigator 3.0: This property is tainted by default. It has no value of data tainting is disabled. For information on data tainting, see "JavaScript Security".

Navigator 4.0: Getting the value of this property requires the UniversalBrowserRead privilege. It has no value if you do not have this privilege. 要获取 Navigator 4.0 中关于安全性更多的信息,请看“JavaScript 指南”中的第七章“JavaScript 安全性”

示例

The following example determines whether 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

length

The number of elements in the history array.

属性源 History
只读
实现版本 Navigator 2.0

安全性

Navigator 4.0: Getting the value of this property requires the UniversalBrowserRead privilege. 要获取 Navigator 4.0 中关于安全性更多的信息,请看“JavaScript 指南”中的第七章“JavaScript 安全性”

next

A string specifying the complete URL of the next history entry.

属性源 History
只读
实现版本 Navigator 3.0

安全性

Navigator 3.0: This property is tainted by default. It has no value of data tainting is disabled. For information on data tainting, see "JavaScript Security".

Navigator 4.0: Getting the value of this property requires the UniversalBrowserRead privilege. It has no value if you do not have this privilege. 要获取 Navigator 4.0 中关于安全性更多的信息,请看“JavaScript 指南”中的第七章“JavaScript 安全性”

描述

The next property reflects the URL that would be used if the user chose Forward from the Go menu.

示例

The following example determines whether 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

previous

A string specifying the complete URL of the previous history entry.

属性源 History
只读
实现版本 Navigator 3.0

安全性

Navigator 3.0: This property is tainted by default. It has no value of data tainting is disabled. For information on data tainting, see "JavaScript Security".

Navigator 4.0: Getting the value of this property requires the UniversalBrowserRead privilege. It has no value if you do not have this privilege. 要获取 Navigator 4.0 中关于安全性更多的信息,请看“JavaScript 指南”中的第七章“JavaScript 安全性”

描述

The previous property reflects the URL that would be used if the user chose Back from the Go menu.

示例

The following example determines whether 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

方法

back

Loads the previous URL in the history list.

方法源 History
实现版本 Navigator 2.0

语法

back()

参数

描述

This method performs the same action as a user choosing the Back button in the browser. The back method is the same as history.go(-1).

示例

The following custom buttons perform the same operation as the browser's Back button:

<P><INPUT TYPE="button" VALUE="< Go Back"
   onClick="history.back()">
<P><INPUT TYPE="button" VALUE="> Go Back"
   onClick="myWindow.back()">

参看

History.forward, History.go

forward

Loads the next URL in the history list.

方法源 History
实现版本 Navigator 2.0

语法

forward()

参数

描述

This method performs the same action as a user choosing the Forward button in the browser. The forward method is the same as history.go(1).

示例

The following custom buttons perform the same operation as the browser's Forward button:

<P><INPUT TYPE="button" VALUE="< Forward"
   onClick="history.forward()">
<P><INPUT TYPE="button" VALUE="> Forward"
   onClick="myWindow.forward()">

参看

History.back, History.go

go

Loads a URL from the history list.

方法源 History
实现版本 Navigator 2.0

语法

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.

描述

The 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描述 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.

示例

The following button navigates to the nearest history entry that contains the string "home.netscape.com":

<P><INPUT TYPE="button" VALUE="Go"
   onClick="history.go('home.netscape.com')">
The following button navigates to the URL that is three entries backward in the history list:

<P><INPUT TYPE="button" VALUE="Go"
   onClick="history.go(-3)">

参看

History.back, History.forward, Location.reload, Location.replace


【目录】 【上一页】 【下一页】 【索引】

回页面顶部