Sent when a browser is about to navigate to a new url in a frame
# Metadata
Platforms: desktop OS: mac, windows Introduced: 2.8.1 Security: network
# Syntax
browserBeforeNavigateFrame pInstanceId, pUrl
# Params
- pInstanceID : The integer identifier of the browser object - pUrl : The new url that is about to be navigated to in the frame
# Examples
on browserBeforeNavigateFrame pInstanceId, pUrl if not browserFrameNavAllowed() then global browserCancel put true into browserCancel end if end browserBeforeNavigateFrame
# Description
The browserBeforeNavigateFrame message is sent to the current card of a stack containg a browser object when the browser object is about to navigate to a new url in a frame. i.e. a change in the url in the target browser has been requested but not yet actioned.
If the target is the main frame of the browser then the browserBeforeNavigate message is sent instead.
To prevent the navigation occuring, set the global variable browserCancel to true
>*Note:* For general information on using the browser library, see the > notes in the revBrowserOpen function reference.
# Tags
# See
- **glossary:** function, browserCancel, message - **message:** browserBeforeNavigate, browserDownloadRequest, browserNavigateCompleteFrame - **function:** revBrowserOpen