Interface CefriumNavigationClient


@CefriumExperimental public interface CefriumNavigationClient
Called on the UI thread. Navigation events of a CefriumBrowser, like android.webkit.WebViewClient. Set it with CefriumBrowser.setNavigationClient(CefriumNavigationClient); every method has a default, so implement only the ones you need. The browser is the first parameter, so one client can serve several browsers.
  • Method Details

    • onBeforeNavigate

      default boolean onBeforeNavigate(CefriumBrowser browser, CefriumNavigationRequest request)
      A page or iframe is about to navigate. Return true to cancel it, for example to hand a link to another app; false lets it go on.

      Like WebViewClient.shouldOverrideUrlLoading: called before the request is sent, for navigations the page starts (links, forms, scripts) and for every server redirect. Not called for a load the app starts (CefriumBrowser.loadUrl(String) and the like) or for back and forward. It must answer quickly: the navigation waits for it.

    • onUrlChanged

      default void onUrlChanged(CefriumBrowser browser, String url)
      The address of the page changed (a navigation, or the page's own history).
    • onLoadStart

      default void onLoadStart(CefriumBrowser browser, String url)
      The page started loading url (WebView's onPageStarted).
    • onLoadingStateChanged

      default void onLoadingStateChanged(CefriumBrowser browser, boolean loading, boolean canGoBack, boolean canGoForward)
      The browser started or stopped loading. loading == false is WebView's onPageFinished. The back and forward states are the ones after the change.
    • onProgressChanged

      default void onProgressChanged(CefriumBrowser browser, int percent)
      How much of the page has loaded, 0 to 100 (WebView's onProgressChanged).
    • onLoadError

      default void onLoadError(CefriumBrowser browser, CefriumLoadError error)
      The page failed to load (WebView's onReceivedError, main frame).
    • onRenderProcessTerminated

      default void onRenderProcessTerminated(CefriumBrowser browser, CefriumRendererTerminationStatus status, int errorCode)
      The page's renderer process ended; the page is gone until it is loaded again (CefriumBrowser.reload()).
      Parameters:
      errorCode - the process's exit code, 0 if none
    • onDocumentAvailable

      default void onDocumentAvailable(CefriumBrowser browser)
      The page's document exists and its scripts can run (before it has loaded).
    • onRenderProcessUnresponsive

      default void onRenderProcessUnresponsive(CefriumBrowser browser)
      The page's renderer stopped answering (a long-running script, for example).
    • onRenderProcessResponsive

      default void onRenderProcessResponsive(CefriumBrowser browser)
      The renderer answers again after onRenderProcessUnresponsive(CefriumBrowser).
    • onSslError

      default void onSslError(CefriumBrowser browser, CefriumSslError error, CefriumBrowser.SslErrorCallback callback)
      A certificate failed validation. Call callback.proceed() to load anyway (for example after checking error.getCertificate() against a pinned one) or cancel(); now or later, from any thread. The default cancels.
    • onHttpAuthRequest

      default void onHttpAuthRequest(CefriumBrowser browser, String host, String realm, int port, boolean isProxy, CefriumBrowser.HttpAuthCallback callback)
      A server or proxy asks for a user name and password (HTTP authentication). Answer with callback.proceed(user, password) or cancel(), from any thread. The default cancels.
    • onSelectClientCertificate

      default void onSelectClientCertificate(CefriumBrowser browser, boolean isProxy, String host, int port, List<String> subjects, CefriumClientCertificateCallback callback)
      A server asks for a client certificate (mutual TLS). Pick one of subjects by index, or cancel to go on without one. The default cancels.