Name: browserDocumentFailed

Type: message

Syntax: browserDocumentFailed <pInstanceId>, <pUrl>, <pErrorMessage>

Summary:
Sent when a browser object has encountered an error when loading a url

Introduced: 6.7.3

OS: mac, windows

Platforms: desktop

Security: network

Example:
on browserDocumentFailed pInstanceId, pUrl, pErrorMessage
  answer "Failed to load URL" && quote \
        & pUrl & quote & return & "Error message: " && pErrorMessage
end browserDocumentFailed

Parameters:
pInstanceId:
The integer identifier of the browser object

pUrl:
The url that has failed to load

pErrorMessage:
A message explaining why the url failed to load

Description:
The <browserDocumentFailed> message is sent to the current card of a
stack containing a browser object when the browser object has
encountered an error while loading a url and all its dependent
resources. 

If the target is the main frame of the browser (e.g. the html page with
the "FRAMESET" declaration), then the <browserDocumentFailed> message is
sent. Otherwise the <browserDocumentFailedFrame> <message> is sent
instead. 

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

References: revBrowserOpenCef (function),
revBrowserOpen (function), function (glossary), browserDownloadRequest (message),
browserDocumentFailedFrame (message), message (glossary)

