JavaScript: The Definitive Guide, Fourth Edition

Name

Window.routeEvent( ) — pass a captured event to the next handler

Availability

Netscape 4

Synopsis

                  window.routeEvent(event) document.routeEvent(event)
layer.routeEvent(event)

Arguments

event

The captured Event object to be routed to the next event handler.

Returns

Whatever value was returned by the handler to which the event was routed.

Description

routeEvent( ) is a method of the Window, Document, and Layer classes, and it behaves the same for all three. When a captured Event object, event, is passed to an event handler of window, document, or layer, that handler may choose to pass the event on to the next interested event handler, if any. If the window, document, or layer contains some other window (frame), document, or layer that has also used captureEvents( ) to register interest in events of that type, the event is routed to the appropriate handler on that window, document, or layer object.

On the other hand, if there is no containing window, document, or layer object that has expressed interest in the event, routeEvent( ) passes the event object to the appropriate event handler of the object on which the event originated. The combination of captureEvents( ) and routeEvent( ) forms the basis of the “trickle-down” event model of Netscape 4.

See Also

Window.captureEvents( ), Window.handleEvent( ), Window.releaseEvents( ); Chapter 19