@@ -45,23 +45,24 @@ calls to OnLoadError and/or OnLoadEnd.
4545| frame | [ Frame] ( Frame.md ) |
4646| __ Return__ | void |
4747
48+ Description from upstream CEF:
49+ > Called after a navigation has been committed and before the browser begins
50+ > loading contents in the frame. The |frame| value will never be empty --
51+ > call the IsMain() method to check if this frame is the main frame.
52+ > |transition_type| provides information about the source of the navigation
53+ > and an accurate value is only available in the browser process. Multiple
54+ > frames may be loading at the same time. Sub-frames may start or continue
55+ > loading after the main frame load has ended. This method will not be called
56+ > for same page navigations (fragments, history state, etc.) or for
57+ > navigations that fail or are canceled before commit. For notification of
58+ > overall browser load status use OnLoadingStateChange instead.
59+
4860This callback is called for a number of different reasons, including when
4961history.pushState or history.replaceState changes the reference fragment
5062for the currently loaded page. In most cases you want to use
5163OnLoadingStateChange. In newer CEF there is |transition_type| arg that
5264provides information about the source of the navigation.
5365
54- Description from upstream CEF:
55- > Called when the browser begins loading a frame. The |frame| value will
56- > never be empty -- call the IsMain() method to check if this frame is the
57- > main frame. |transition_type| provides information about the source of the
58- > navigation and an accurate value is only available in the browser process.
59- > Multiple frames may be loading at the same time. Sub-frames may
60- > start or continue loading after the main frame load has ended. This method
61- > will always be called for all frames irrespective of whether the request
62- > completes successfully. For notification of overall browser load status use
63- > [ DisplayHandler] ( DisplayHandler.md ) .` OnLoadingStateChange ` instead.
64-
6566
6667### OnDomReady
6768
@@ -81,13 +82,15 @@ Not yet implemented. See [Issue #32](../issues/32).
8182| http_code | int |
8283| __ Return__ | void |
8384
84- Called when the browser is done loading a frame. The |frame| value will
85- never be empty -- call the IsMain() method to check if this frame is the
86- main frame. Multiple frames may be loading at the same time. Sub-frames may
87- start or continue loading after the main frame load has ended. This method
88- will always be called for all frames irrespective of whether the request
89- completes successfully. For notification of overall browser load status use
90- OnLoadingStateChange instead.
85+ Description from upstream CEF:
86+ > Called when the browser is done loading a frame. The |frame| value will
87+ > never be empty -- call the IsMain() method to check if this frame is the
88+ > main frame. Multiple frames may be loading at the same time. Sub-frames may
89+ > start or continue loading after the main frame load has ended. This method
90+ > will not be called for same page navigations (fragments, history state,
91+ > etc.) or for navigations that fail or are canceled before commit. For
92+ > notification of overall browser load status use OnLoadingStateChange
93+ > instead.
9194
9295This event behaves like window.onload, it waits for all the content
9396to load (e.g. images), there is currently no callback for
@@ -108,10 +111,12 @@ topic: http://www.magpcss.org/ceforum/viewtopic.php?f=6&t=10906
108111| failed_url | string |
109112| __ Return__ | void |
110113
111- Called when the resource load for a navigation fails or is canceled.
112- |errorCode| is the error code number, |error_text_out[ 0] | is the error
113- text and |failed_url| is the URL that failed to load. See
114- net\base\net_error_list.h for complete descriptions of the error codes.
114+ Description from upstream CEF:
115+ > Called when a navigation fails or is canceled. This method may be called
116+ > by itself if before commit or in combination with OnLoadStart/OnLoadEnd if
117+ > after commit. |errorCode| is the error code number, |errorText| is the
118+ > error text and |failedUrl| is the URL that failed to load.
119+ > See net\base\net_error_list.h for complete descriptions of the error codes.
115120
116121This callback may get called when [ Browser] ( Browser.md ) .` StopLoad `
117122is called, or when file download is aborted (see DownloadHandler).
0 commit comments