document.fgColor
Implemented in
Navigator 2.0
Description
The fgColor property is expressed as a hexadecimal RGB triplet or as one of the string literals listed in "Color values". This property is the JavaScript reflection of the TEXT attribute of the <BODY> tag. The default value of this property is set by the user on the Colors tab of the Preferences dialog box, which is displayed by choosing General Preferences from the Options menu. You cannot set this property after the HTML source has been through layout.
If you express the color as a hexadecimal RGB triplet, you must use the format rrggbb. For example, the hexadecimal RGB values for salmon are red=FA, green=80, and blue=72, so the RGB triplet for salmon is "FA8072."
You can override the value set in the fgColor property in either of the following ways:
Examples
The following example sets the color of the foreground text to aqua using a string literal:
document.fgColor="aqua"
The following example sets the color of the foreground text to aqua using a hexadecimal triplet:
document.fgColor="00FFFF"
See also
alinkColor, bgColor, linkColor, vlinkColor properties; fontcolor method
1. navigator.plugins[index].filename
2. navigator.plugins[pluginName].filename
Implemented in
Navigator 3.0
Description
The filename property is the plug-in's file name and is supplied by the plug-in itself.
filename is a read-only property.
Examples
See the examples for the Plugin object.
See also
description, length, name properties
<INPUT
TYPE="file"
NAME="fileUploadName">
fileUploadName.propertyName
Implemented in
Navigator 3.0
Description
A FileUpload object on a form looks as follows:
A FileUpload object is a form element and must be defined within a <FORM> tag.
You can place a FileUpload object on a form but you cannot use JavaScript to modify it in any way.
Properties
The FileUpload object has the following properties:
Methods
Event handlers
Examples
The following example places a FileUpload object on a form and provides two buttons that let the user display current values of the name and value properties.
<FORM NAME="form1">
File to send: <INPUT TYPE="file" NAME="myUploadObject">
<P>Get properties<BR>
<INPUT TYPE="button" VALUE="name"
onClick="alert('name: ' + document.form1.myUploadObject.name)">
<INPUT TYPE="button" VALUE="value"
onClick="alert('value: ' + document.form1.myUploadObject.value)"><BR>
</FORM> See also
Text object
stringName.fixed()
Implemented in
Navigator 2.0
Description
Use the fixed method with the write or writeln methods to format and display a string in a document. In LiveWire, use the write function to display the string.
Examples
The following example uses the fixed method to change the formatting of a string:
var worldString="Hello, world"
The previous example produces the same output as the following HTML:
document.write(worldString.fixed())<TT>Hello, world</TT>
In LiveWire, you can generate this HTML by calling the write function instead of using document.write
.
Math.floor(number)
Implemented in
Navigator 2.0
Examples
The following function returns the floor value of the variable x:
function getFloor(x) {
If you pass getFloor the value 45.95, it returns 45; if you pass it the value -45.95, it returns -46.
return Math.floor(x)
} See also
ceil method
1. passwordName.focus()
2. selectName.focus()
3. textName.focus()
4. textareaName.focus()
5. frameReference.focus()
6. windowReference.focus()
windowReference is a valid way of referring to a window, as described in the window object.
Method of
Frame object, Password object, Select object, Text object, Textarea object, window object
Implemented in
Description
Use the focus method to navigate to a specific form element and give it focus. You can then either programmatically enter a value in the element or let the user enter a value.
The focus method gives focus to a window or frame. Giving focus brings a window forward in most windowing systems.
Examples
In the following example, the checkPassword function confirms that a user has entered a valid password. If the password is not valid, the focus method returns focus to the Password object and the select method highlights it so the user can re-enter the password.
function checkPassword(userPass) {
This example assumes that the Password object is defined as
if (badPassword) {
alert("Please enter your password again.")
userPass.focus()
userPass.select()
}
}<INPUT TYPE="password" NAME="userPass">
See also
blur method, select method
stringName.fontcolor(color)
Implemented in
Navigator 2.0
Description
Use the fontcolor method with the write or writeln methods to format and display a string in a document. In LiveWire, use the write function to display the string.
If you express color as a hexadecimal RGB triplet, you must use the format rrggbb. For example, the hexadecimal RGB values for salmon are red=FA, green=80, and blue=72, so the RGB triplet for salmon is "FA8072."
The fontcolor method overrides a value set in the fgColor property.
Examples
The following example uses the fontcolor method to change the color of a string:
var worldString="Hello, world"
The previous example produces the same output as the following HTML:
document.write(worldString.fontcolor("maroon") +
" is maroon in this line")
document.write("<P>" + worldString.fontcolor("salmon") +
" is salmon in this line")
document.write("<P>" + worldString.fontcolor("red") +
" is red in this line")
document.write("<P>" + worldString.fontcolor("8000") +
" is maroon in hexadecimal in this line")
document.write("<P>" + worldString.fontcolor("FA8072") +
" is salmon in hexadecimal in this line")
document.write("<P>" + worldString.fontcolor("FF00") +
" is red in hexadecimal in this line")<FONT COLOR="maroon">Hello, world</FONT> is maroon in this line
In LiveWire, you can generate this HTML by calling the write function instead of using
<P><FONT COLOR="salmon">Hello, world</FONT> is salmon in this line
<P><FONT COLOR="red">Hello, world</FONT> is red in this line
<FONT COLOR="8000">Hello, world</FONT> is maroon in hexadecimal in this line
<P><FONT COLOR="FA8072">Hello, world</FONT> is salmon in hexadecimal in this line
<P><FONT COLOR="FF00">Hello, world</FONT> is red in hexadecimal in this linedocument.write
.
stringName.fontsize(size)
Implemented in
Navigator 2.0
Description
Use the fontsize method with the write or writeln methods to format and display a string in a document. In LiveWire, use the write function to display the string.
When you specify size as an integer, you set the size of stringName to one of the seven defined sizes. When you specify size as a string such as "-2," you adjust the font size of stringName relative to the size set in the <BASEFONT> tag.
Examples
The following example uses string methods to change the size of a string:
var worldString="Hello, world"
The previous example produces the same output as the following HTML:
document.write(worldString.small())
document.write("<P>" + worldString.big())
document.write("<P>" + worldString.fontsize(7))<SMALL>Hello, world</SMALL>
In LiveWire, you can generate this HTML by calling the write function instead of using
<P><BIG>Hello, world</BIG>
<P><FONTSIZE=7>Hello, world</FONTSIZE>document.write
.
See also
big, small methods
<FORM
NAME="formName"
TARGET="windowName"
ACTION="serverURL"
METHOD=GET | POST
ENCTYPE="encodingType"
[onReset="handlerText"]
[onSubmit="handlerText"]>
</FORM>
1. formName.propertyName
2. formName.methodName(parameters)
3. forms[index].propertyName
4. forms[index].methodName(parameters)
Implemented in
Description
Each form in a document is a distinct object.
You can reference a form's elements in your code by using the element's name (from the NAME attribute) or the elements array. The elements array contains an entry for each element (such as a Checkbox, Radio, or Text object) in a form.
The forms array
You can reference the forms in your code by using the forms array (you can also use the form name). This array contains an entry for each Form object (<FORM> tag) in a document in source order. For example, if a document contains three forms, these forms are reflected as document.forms[0]
, document.forms[1]
, and document.forms[2]
.
To use the forms array:
1. document.forms[index]
index is an integer representing a form in a document.
To obtain the number of forms in a document, use the length property:
2. document.forms.lengthdocument.forms.length
.
You can also refer to a form's elements by using the forms array. For example, you would refer to a Text object named quantity in the second form as document.forms[1].quantity
. You would refer to the value property of this Text object as document.forms[1].quantity.value
.
Elements in the forms array are read-only. For example, the statement document.forms[0]="music"
has no effect.
The value of each element in the forms array is <object
nameAttribute>, where nameAttribute is the NAME attribute of the form.
Properties
The Form object has the following properties:
The following objects are also properties of the Form object:
The forms array has the following properties:
Property |
Description
length |
Reflects the number of forms in the document |
|
---|
Methods
Event handlers
Examples
Example 1: Named form. The following example creates a form called form1 that contains text fields for first name and last name. The form also contains two buttons that change the names to all uppercase or all lowercase. The function setCase shows how to refer to the form by its name.
<HTML>
Example 2: forms array. The onLoad event handler in the following example displays the name of the first form in an Alert dialog box.
<HEAD>
<TITLE>Form object example</TITLE>
</HEAD>
<SCRIPT>
function setCase (caseSpec){
if (caseSpec == "upper") {
document.form1.firstName.value=document.form1.firstName.value.toUpperCase()
document.form1.lastName.value=document.form1.lastName.value.toUpperCase()}
else {
document.form1.firstName.value=document.form1.firstName.value.toLowerCase()
document.form1.lastName.value=document.form1.lastName.value.toLowerCase()}
}
</SCRIPT>
<BODY>
<FORM NAME="form1">
<B>First name:</B>
<INPUT TYPE="text" NAME="firstName" SIZE=20>
<BR><B>Last name:</B>
<INPUT TYPE="text" NAME="lastName" SIZE=20>
<P><INPUT TYPE="button" VALUE="Names to uppercase" NAME="upperButton"
onClick="setCase('upper')">
<INPUT TYPE="button" VALUE="Names to lowercase" NAME="lowerButton"
onClick="setCase('lower')">
</FORM>
</BODY>
</HTML><BODY onLoad="alert('You are looking at the ' + document.forms[0] + ' form!')">
If the form name is musicType, the alert displays the following message:
You are looking at the <object musicType> form!
Example 3: onSubmit event handler. The following example shows an onSubmit event handler that determines whether to submit a form. The form contains one Text object where the user enters three characters. The onSubmit event handler calls a function, checkData, that returns true if the number of characters is three; otherwise, it returns false. Notice that the form's onSubmit event handler, not the submit button's onClick event handler, calls the checkData function. Also, the onSubmit event handler contains a return statement that returns the value obtained with the function call.
<HTML>
Example 4: submit method. The following example is similar to the previous one, except it submits the form using the submit method instead of a Submit object. The form's onSubmit event handler does not prevent the form from being submitted. The form uses a button's onClick event handler to call the checkData function. If the value is valid, the checkData function submits the form by calling the form's submit method.
<HEAD>
<TITLE>Form object/onSubmit event handler example</TITLE>
<TITLE>Form object example</TITLE>
</HEAD>
<SCRIPT>
var dataOK=false
function checkData (){
if (document.form1.threeChar.value.length == 3) {
return true}
else {
alert("Enter exactly three characters. " + document.form1.threeChar.value +
" is not valid.")
return false}
}
</SCRIPT>
<BODY>
<FORM NAME="form1" onSubmit="return checkData()">
<B>Enter 3 characters:</B>
<INPUT TYPE="text" NAME="threeChar" SIZE=3>
<P><INPUT TYPE="submit" VALUE="Done" NAME="submit1"
onClick="document.form1.threeChar.value=document.form1.threeChar.value.toUpperCase()">
</FORM>
</BODY>
</HTML><HTML>
<HEAD>
<TITLE>Form object/submit method example</TITLE>
</HEAD>
<SCRIPT>
var dataOK=false
function checkData (){
if (document.form1.threeChar.value.length == 3) {
document.form1.submit()}
else {
alert("Enter exactly three characters. " + document.form1.threeChar.value +
" is not valid.")
return false}
}
</SCRIPT>
<BODY>
<FORM NAME="form1" onSubmit="alert('Form is being submitted.')">
<B>Enter 3 characters:</B>
<INPUT TYPE="text" NAME="threeChar" SIZE=3>
<P><INPUT TYPE="button" VALUE="Done" NAME="button1"
onClick="checkData()">
</FORM>
</BODY>
</HTML> See also
Button object, Checkbox object, Hidden object, Password object, Radio object, Reset object, Select object, Submit object, Text object, Textarea object
history.forward()
Implemented in
Navigator 2.0
Description
This method performs the same action as a user choosing the Forward button in the Navigator. The forward method is the same as history.go(1)
.
Examples
The following custom buttons perform the same operations as the Navigator Back and Forward buttons:
<P><INPUT TYPE="button" VALUE="< Back"
onClick="history.back()">
<P><INPUT TYPE="button" VALUE="> Forward"
onClick="history.forward()"> See also
back, go methods
<FRAMESET
ROWS="rowHeightList"
COLS="columnWidthList"
[onBlur="handlerText"]
[onFocus="handlerText"]
[onLoad="handlerText"]
[onUnload="handlerText"]>
[ ... <FRAME SRC="locationOrURL" NAME="frameName">]
</FRAMESET>
FRAME SRC="doc2.html#colors" NAME="frame2">
is invalid. See the location object for a description of the URL components.
NAME="frameName" specifies a name to be used as a target of hyperlink jumps.
1. [windowReference.]frameName.propertyNameTo define an onBlur or onFocus event handler for a frame (for frames, you cannot specify these event handlers in HTML):
2. [windowReference.]frames[index].propertyName
3. window.propertyName
4. self.propertyName
5. parent.propertyName
1. frameReference.onblur=errorHandler
2. frameReference.onfocus=errorHandler
frameName is the value of the NAME attribute in the <FRAME> tag of a Frame object.
index is an integer representing a Frame object.
propertyName is one of the properties listed below.
frameReference is a valid way of referring to a frame.
errorHandler is the keyword null, the name of an error-handling function, or a variable or property that contains null or a valid function reference.
Property of
The Frame object is a property of the window object.
The frames array is a property of both the Frame object and window object.
Implemented in
Description
The <FRAMESET> tag is used in an HTML document whose sole purpose is to define the layout of frames that make up a page. Each frame is a window object.
If a <FRAME> tag contains SRC and NAME attributes, you can refer to that frame from a sibling frame by using parent.
frameName or parent.frames[
index]
. For example, if the fourth frame in a set has NAME="homeFrame," sibling frames can refer to that frame using parent.homeFrame
or parent.frames[3]
.
The self and window properties are synonyms for the current frame, and you can optionally use them to refer to the current frame. You can use these properties to make your code more readable. See the properties listed below for examples.
The top and parent properties are also synonyms that can be used in place of the frame name. top refers to the top-most window that contains frames or nested framesets, and parent refers to the window containing the current frameset. See the top and parent properties.
To create an onBlur or onFocus event handler for a frame, you must set the onblur or onfocus property and specify it in all lowercase (you cannot specify it in HTML).
The frames array
You can reference the Frame objects in your code by using the frames array. This array contains an entry for each child frame (<FRAME> tag) in a window containing a <FRAMESET> tag in source order. For example, if a window contains three child frames, these frames are reflected as parent.frames[0]
, parent.frames[1]
, and parent.frames[2]
.
To use the frames array:
1. [frameReference.]frames[index]
frameReference is a valid way of referring to a frame.
windowReference is a variable windowVar from a window definition (see the window object), or one of the synonyms top or parent.
2. [frameReference.]frames.length
3. [windowReference.]frames[index]
4. [windowReference.]frames.length
index is an integer representing a frame in a parent window.
To obtain the number of child frames in a window or frame, use the length property:
[windowReference.].frames.length
Elements in the frames array are read-only. For example, the statement windowReference
[frameReference.].frames.length.frames[0]="frame1"
has no effect.
The value of each element in the frames array is <object
nameAttribute>, where nameAttribute is the NAME attribute of the frame.
Properties
The Frame object has the following properties:
The frames array has the following properties:
Property |
Description
length |
Reflects the number of child frames in the document |
|
---|
The onLoad and onUnload event handlers are specified in the <FRAMESET> tag but are actually event handlers for the window object. Methods
Event handlers
Examples
The following example creates two windows, each with four frames. In the first window, the first frame contains pushbuttons that change the background colors of the frames in both windows. framset1.html
, which defines the frames for the first window, contains the following code:
<HTML>
<HEAD>
<TITLE>Frames and Framesets: Window 1</TITLE>
</HEAD>
<FRAMESET ROWS="50%,50%" COLS="40%,60%"
onLoad="alert('Hello, World.')">
<FRAME SRC=framcon1.html NAME="frame1">
<FRAME SRC=framcon2.html NAME="frame2">
<FRAME SRC=framcon2.html NAME="frame3">
<FRAME SRC=framcon2.html NAME="frame4">
</FRAMESET>
</HTML>framset2.html
, which defines the frames for the second window, contains the following code:
<HTML>
<HEAD>
<TITLE>Frames and Framesets: Window 2</TITLE>
</HEAD>
<FRAMESET ROWS="50%,50%" COLS="40%,60%">
<FRAME SRC=framcon2.html NAME="frame1">
<FRAME SRC=framcon2.html NAME="frame2">
<FRAME SRC=framcon2.html NAME="frame3">
<FRAME SRC=framcon2.html NAME="frame4">
</FRAMESET>
</HTML>framcon1.html
, which defines the content for the first frame in the first window, contains the following code:
<HTML>
<BODY>
<A NAME="frame1"><H1>Frame1</H1></A>
<P><A HREF="framcon3.htm" target=frame2>Click here</A>
to load a different file into frame 2.
<SCRIPT>
window2=open("framset2.htm","secondFrameset")
</SCRIPT>
<FORM>
<P><INPUT TYPE="button" VALUE="Change frame2 to teal"
onClick="parent.frame2.document.bgColor='teal'">
<P><INPUT TYPE="button" VALUE="Change frame3 to slateblue"
onClick="parent.frames[2].document.bgColor='slateblue'">
<P><INPUT TYPE="button" VALUE="Change frame4 to darkturquoise"
onClick="top.frames[3].document.bgColor='darkturquoise'">
<P><INPUT TYPE="button" VALUE="window2.frame2 to violet"
onClick="window2.frame2.document.bgColor='violet'">
<P><INPUT TYPE="button" VALUE="window2.frame3 to fuchsia"
onClick="window2.frames[2].document.bgColor='fuchsia'">
<P><INPUT TYPE="button" VALUE="window2.frame4 to deeppink"
onClick="window2.frames[3].document.bgColor='deeppink'">
</FORM>
</BODY>
</HTML>framcon2.html
, which defines the content for the remaining frames, contains the following code:
<HTML>
<BODY>
<P>This is a frame.
</BODY>
</HTML>framcon3.html
, which is referenced in a Link object in framcon1.html
, contains the following code:
<HTML>
<BODY>
<P>This is a frame. What do you think?
</BODY>
</HTML> See also
document object, window object
functionTarget = new Function ([arg1, arg2, ... argn], functionBody)
window.onerror
.
arg1, arg2, ... argn are string arguments to be used by the function as formal argument names.
functionBody is a string specifying the JavaScript code to be compiled as the function body.
var setBGColor = new Function("document.bgColor='antiquewhite'")To call the Function object, you can specify the variable name as if it were a function. The following code executes the function specified by the setBGColor variable:
var colorChoice="antiquewhite"You can assign the function to an event handler in either of the following ways:
if (colorChoice=="antiquewhite") {setBGColor()}
1. document.form1.colorButton.onclick=setBGColorCreating the variable setBGColor shown above is similar to declaring the following function:
2. <INPUT NAME="colorButton" TYPE="button"
VALUE="Change background color"
onClick="setBGColor()">
function setBGColor() {Assigning a function to a variable is similar to declaring a function, but they have differences:
document.bgColor='antiquewhite'
}
var setBGColor = new Function("...")
, setBGColor is a variable for which the current value is a reference to the function created with new Function()
.
function setBGColor() {...}
, setBGColor is not a variable, it is the name of a function.var multFun = new Function("x", "y", "return x * y")The string arguments "x" and "y" are formal argument names that are used in the function body, "return x * y". The following code shows several ways to call the function multFun:
var theAnswer = multFun(7,6)You cannot call the function multFun in an event handler property, because these properties cannot take arguments. For example, you cannot call the function multFun by setting a button's onclick property as follows:
document.write("15*2 = " + multFun(15,2))
<INPUT NAME="operand1" TYPE="text" VALUE="5" SIZE=5>
<INPUT NAME="operand2" TYPE="text" VALUE="6" SIZE=5>
<INPUT NAME="result" TYPE="text" VALUE="" SIZE=10>
<INPUT NAME="buttonM" TYPE="button" VALUE="Multiply"
onClick="document.form1.result.value=
multFun(document.form1.operand1.value,
document.form1.operand2.value)">
document.form1.button1.onclick=multFun(5,10)
window.onfocus = new Function("document.bgColor='antiquewhite'")Once you have a reference to a function object, you can use it like a function and it will convert from an object to a function:
window.onfocus()Event handlers do not take arguments, so you cannot declare any arguments in the Function() constructor for an event handler.
Property |
Description
arguments array |
Corresponds to elements of a function. |
prototype |
Lets you add a properties to a Function object. |
|
---|
Methods
Event handlers
Examples
The following example creates onFocus and onBlur event handlers for a frame. This code exists in the same file that contains the <FRAMESET> tag. Note that this is the only way to create onFocus and onBlur event handlers for a frame, because you cannot specify the event handlers in the <FRAME> tag.
frames[0].onfocus = new Function("document.bgColor='antiquewhite'")
frames[0].onblur = new Function("document.bgColor='lightgrey'")
dateObjectName.getDate()
Implemented in
Navigator 2.0
Description
The value returned by getDate is an integer between one and thirty-one.
Examples
The second statement below assigns the value twenty-five to the variable day, based on the value of the Date object Xmas95.
Xmas95 = new Date("December 25, 1995 23:15:00")
day = Xmas95.getDate() See also
setDate method
dateObjectName.getDay()
Implemented in
Navigator 2.0
Description
The value returned by getDay is an integer corresponding to the day of the week: zero for Sunday, one for Monday, two for Tuesday, and so on.
Examples
The second statement below assigns the value 1 to weekday, based on the value of the Date object Xmas95. This is because December 25, 1995, is a Monday.
Xmas95 = new Date("December 25, 1995 23:15:00")
weekday = Xmas95.getDay()
dateObjectName.getHours()
Implemented in
Navigator 2.0
Description
The value returned by getHours is an integer between zero and twenty-three.
Examples
The second statement below assigns the value twenty-three to the variable hours, based on the value of the Date object Xmas95.
Xmas95 = new Date("December 25, 1995 23:15:00")
hours = Xmas95.getHours() See also
setHours method
dateObjectName.getMinutes()
Implemented in
Navigator 2.0
Description
The value returned by getMinutes is an integer between zero and fifty-nine.
Examples
The second statement below assigns the value fifteen to the variable minutes, based on the value of the Date object Xmas95.
Xmas95 = new Date("December 25, 1995 23:15:00")
minutes = Xmas95.getMinutes() See also
setMinutes method
dateObjectName.getMonth()
Implemented in
Navigator 2.0
Description
The value returned by getMonth is an integer between zero and eleven. Zero corresponds to January, one to February, and so on.
Examples
The second statement below assigns the value eleven to the variable month, based on the value of the Date object Xmas95.
Xmas95 = new Date("December 25, 1995 23:15:00")
month = Xmas95.getDate() See also
setMonth method
dateObjectName.getSeconds()
Implemented in
Navigator 2.0
Description
The value returned by getSeconds is an integer between zero and fifty-nine.
Examples
The second statement below assigns the value thirty to the variable secs, based on the value of the Date object Xmas95.
Xmas95 = new Date("December 25, 1995 23:15:30")
secs = Xmas95.getSeconds() See also
setSeconds method
dateObjectName.getTime()
Implemented in
Navigator 2.0
Description
The value returned by the getTime method is the number of milliseconds since 1 January 1970 00:00:00. You can use this method to help assign a date and time to another Date object.
Examples
The following example assigns the date value of theBigDay to sameAsBigDay:
theBigDay = new Date("July 1, 1999")
sameAsBigDay = new Date()
sameAsBigDay.setTime(theBigDay.getTime()) See also
setTime method
dateObjectName.getTimezoneOffset()
Implemented in
Navigator 2.0
Description
The time-zone offset is the difference between local time and GMT. Daylight savings time prevents this value from being a constant.
Examples
x = new Date()
currentTimeZoneOffsetInHours = x.getTimezoneOffset()/60
dateObjectName.getYear()
Implemented in
Navigator 2.0
Description
The value returned by getYear is the year less 1900. For example, if the year is 1976, the value returned is seventy-six.
Examples
The second statement below assigns the value ninety-five to the variable year, based on the value of the Date object Xmas95.
Xmas95 = new Date("December 25, 1995 23:15:00")
year = Xmas95.getYear() See also
setYear method
history.go(delta | "location")
Implemented in
Navigator 2.0
Description
The go method navigates to the location in the history list determined by the argument that you specify. You can interactively display the history list by choosing History from the Window menu. Up to ten items in the history list are also displayed on the Go menu.
The delta argument is a positive or negative integer. If delta is greater than zero, 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. If delta is zero, Navigator reloads the current page.
The location argument is a string. Use location to load the nearest history entry whose URL contains location as a substring. The location to URL matching is case-insensitive. Each section of a URL contains different information. See the location object for a description of the URL components.
Examples
The following button navigates to the nearest history entry that contains the string "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)"> See also
back, forward methods