browserBeforeNavigate

Typemessage
DictionaryLCS
LibraryLiveCode Script
Syntax
browserBeforeNavigate <pInstanceID>, <pUrl>
XBrowser_BeforeNavigate <pUrl>, <pInstanceId>
Synonymsxbrowser_beforenavigate
Summary

Sent before a browser navigates to a new url.

Introduced2.8.1
OSmac, windows
Platformsdesktop
Parameters
NameTypeDescription
pInstanceID

The integer identifier of a browser object

pUrl

The new url that the browser is about to navigate to

Example
on browserBeforeNavigate pInstanceId, pUrl
  put pUrl into field "Browser Address" \
        of group ("Browser" && pInstanceId) of me
end browserBeforeNavigate
RelatedMessage: browserNewUrlWindow, browserDownloadRequest, browserBeforeNavigateFrame
Command: revBrowserNavigate
Function: revBrowserOpen
Glossary: function, browserCancel, message
Securitynetwork
Description

The browserBeforeNavigate message is sent to a the current card of the stack containing a browser object when the browser object is about to navigate to a new url, ie a change in url in the target browser has been requested but not yet actioned.

If the target is the main frame of the browser (e.g. the html page containing the "FRAMESET" declaration), then the browserBeforeNavigate message is sent, otherwise the browserBeforeNavigateFrame message is sent instead

To prevent the navigatation from occurring, set the global variable browserCancel to true.

Note: For general information on using the browser library, see the notes in the revBrowserOpen function reference.