[Contents] [Previous] [Next] [Index]

redirect

Redirects the client to the specified URL.

Server-side function

Implemented in

LiveWire 1.0

Syntax

redirect(location)

Parameters

location
The URL to which you want to redirect the client.

Description

The redirect function is a top-level server-side JavaScript function that is not associated with any object.

The redirect function redirects the client browser to the URL specified by the location parameter. The value of location can be relative or absolute.

When the client encounters a redirect function, it loads the specified page immediately and discards the current page. The client does not execute or load any HTML or script statements in the page following the redirect function.

You can use the addClient function to preserve client object property values. See addClient for more information.

Examples

The following example uses the redirect function to redirect a client browser:

redirect("http://www.royalairways.com/lw/apps/newhome.html")
The page displayed by the newhome.html link could contain content such as the following:

<H1>New location</H1>
The URL you tried to access has been moved to:<BR>
<LI><A HREF=http://www.royalairways.com/lw/apps/index.html>
   http://www.royalairways.com/lw/apps/index.html</A>
<P>This notice will remain until 12/31/97.

See also

addClient


[Contents] [Previous] [Next] [Index]

Last Updated: 10/31/97 16:38:00


Copyright � 1997 Netscape Communications Corporation