molybden::BrowserDelegates Class Reference

A class that contains all browser delegates. More...

#include <browser_delegates.hpp>

Inheritance diagram for molybden::BrowserDelegates:

Public Attributes
Delegate< InjectJsArgs, InjectJsAction >	onInjectJs
	Invoked when a document element has been created and a custom JavaScript can be executed before any other JavaScript code on the page.
Delegate< InjectCssArgs, InjectCssAction >	onInjectCss
	Invoked when a web page frame's document element has been created and a custom style sheet can be injected into it.
Delegate< CertErrorArgs, CertErrorAction >	onCertError
	Invoked when an SSL certificate error occurs during loading a web page.
Delegate< VerifyCertArgs, VerifyCertAction >	onVerifyCert
	Invoked when certificate verification is required.
Delegate< OpenPopupArgs, OpenPopupAction >	onOpenPopup
	Invoked when a new popup window has been created and can be displayed.
Delegate< ShowContextMenuArgs, ShowContextMenuAction >	onShowContextMenu
	Invoked when context menu on the loaded web page should be shown.
Delegate< AlertArgs, AlertAction >	onAlert
	Invoked when the JavaScript alert dialog should be displayed.
Delegate< ConfirmArgs, ConfirmAction >	onConfirm
	Invoked when the JavaScript confirmation dialog should be displayed.
Delegate< PromptArgs, PromptAction >	onPrompt
	Invoked when the JavaScript dialog prompting the user to input some text should be displayed.
Delegate< BeforeUnloadArgs, BeforeUnloadAction >	onBeforeUnload
	Invoked when the webpage is about to be unloaded and the JavaScript before unload confirmation dialog should be displayed.
Delegate< BeforeFormRepostArgs, BeforeFormRepostAction >	onBeforeFormRepost
	Invoked when the web page with POST data is going to be reloaded and the user must confirm that the POST data can be resubmitted.
Delegate< SaveAsPdfArgs, SaveAsPdfAction >	onSaveAsPdf
	Invoked when the currently loaded web page is about to save as PDF document and the browser wants to display a file chooser dialog to ask the end user where to save the PDF file.
Delegate< CanExecuteCommandArgs, CanExecuteCommandAction >	onCanExecuteCommand
	Invoked to check if a browser command can be executed or not.
Delegate< StartDownloadArgs, StartDownloadAction >	onStartDownload
	Invoked when the browser is about to start downloading a file.
Delegate< SavePasswordArgs, SavePasswordAction >	onSavePassword
	Invoked when the the user is prompted to save the password credentials in the password store after web form submission.
Delegate< UpdatePasswordArgs, UpdatePasswordAction >	onUpdatePassword
	Invoked when the the user is prompted to update the password credentials in the password store after web form submission.
Delegate< AuthenticateArgs, AuthenticateAction >	onAuthenticate
	Invoked when an HTTP request receives an authentication challenge and it is unable to respond using the cached credentials.
Delegate< RequestPdfPasswordArgs, RequestPdfPasswordAction >	onRequestPdfPassword
	Invoked when a web page needs a password to open an encrypted PDF document.
Delegate< StartCaptureSessionArgs, StartCaptureSessionAction >	onStartCaptureSession
	Invoked when a web page requests permission to start a capture session.
Delegate< SaveCreditCardArgs, SaveCreditCardAction >	onSaveCreditCard
	Invoked when user is prompted to save the credit card credentials in the credit card store after web form submission.
Delegate< SaveUserProfileArgs, SaveUserProfileAction >	onSaveUserProfile
	Invoked when user is prompted to save the user profile in the user profile store after web form submission.
Delegate< UpdateUserProfileArgs, UpdateUserProfileAction >	onUpdateUserProfile
	Invoked when user is prompted to update the user profile in the user profile store after web form submission.

Detailed Description

A class that contains all browser delegates.

Member Data Documentation

onAlert

Delegate<AlertArgs, AlertAction> molybden::BrowserDelegates::onAlert

Invoked when the JavaScript alert dialog should be displayed.

Use the following approach to register a callback:

browser->onAlert = [](const AlertArgs& args, AlertAction action) {};

In order to unregister the callback, use the reset() method:

browser->onAlert.reset();

onAuthenticate

Delegate<AuthenticateArgs, AuthenticateAction> molybden::BrowserDelegates::onAuthenticate

Invoked when an HTTP request receives an authentication challenge and it is unable to respond using the cached credentials.

This callback allows handling "basic" and "digest" authentication.

Use the following approach to register a callback:

browser->onAuthenticate = [](const AuthenticateArgs& args, AuthenticateAction action) {};

In order to unregister the callback, use the reset() method:

browser->onAuthenticate.reset();

onBeforeFormRepost

Delegate<BeforeFormRepostArgs, BeforeFormRepostAction> molybden::BrowserDelegates::onBeforeFormRepost

Invoked when the web page with POST data is going to be reloaded and the user must confirm that the POST data can be resubmitted.

Use the following approach to register a callback:

browser->onBeforeFormRepost = [](const BeforeFormRepostArgs& args, BeforeFormRepostAction action) {};

In order to unregister the callback, use the reset() method:

browser->onBeforeFormRepost.reset();

onBeforeUnload

Delegate<BeforeUnloadArgs, BeforeUnloadAction> molybden::BrowserDelegates::onBeforeUnload

Invoked when the webpage is about to be unloaded and the JavaScript before unload confirmation dialog should be displayed.

Use the following approach to register a callback:

browser->onBeforeUnload = [](const BeforeUnloadArgs& args, BeforeUnloadAction action) {};

In order to unregister the callback, use the reset() method:

browser->onBeforeUnload.reset();

onCanExecuteCommand

Delegate<CanExecuteCommandArgs, CanExecuteCommandAction> molybden::BrowserDelegates::onCanExecuteCommand

Invoked to check if a browser command can be executed or not.

Use the following approach to register a callback:

browser->onCanExecuteCommand = [](const CanExecuteCommandArgs& args, CanExecuteCommandAction action) {};

In order to unregister the callback, use the reset() method:

browser->onCanExecuteCommand.reset();

onCertError

Delegate<CertErrorArgs, CertErrorAction> molybden::BrowserDelegates::onCertError

Invoked when an SSL certificate error occurs during loading a web page.

Use the following approach to register a callback:

browser->onCertError = [](const CertErrorArgs& args, CertErrorAction action) {};

In order to unregister the callback, use the reset() method:

browser->onCertificateError.reset();

onConfirm

Delegate<ConfirmArgs, ConfirmAction> molybden::BrowserDelegates::onConfirm

Invoked when the JavaScript confirmation dialog should be displayed.

Use the following approach to register a callback:

browser->onConfirm = [](const ConfirmArgs& args, ConfirmAction action) {};

In order to unregister the callback, use the reset() method:

browser->onConfirm.reset();

onInjectCss

Delegate<InjectCssArgs, InjectCssAction> molybden::BrowserDelegates::onInjectCss

Invoked when a web page frame's document element has been created and a custom style sheet can be injected into it.

It may be invoked several times for the same frame's document element.

Use the following approach to register a callback:

browser->onInjectCss = [](const InjectCssArgs& args, InjectCssAction action) {};

In order to unregister the callback, use the reset() method:

browser->onInjectCss.reset();

onInjectJs

Delegate<InjectJsArgs, InjectJsAction> molybden::BrowserDelegates::onInjectJs

Invoked when a document element has been created and a custom JavaScript can be executed before any other JavaScript code on the page.

Use the following approach to register a callback:

browser->onInjectJs = [](const InjectJsArgs& args, InjectJsAction action) {};

In order to unregister the callback, use the reset() method:

browser->onInjectJs.reset();

onOpenPopup

Delegate<OpenPopupArgs, OpenPopupAction> molybden::BrowserDelegates::onOpenPopup

Invoked when a new popup window has been created and can be displayed.

Use the following approach to register a callback:

browser->onOpenPopup = [](const OpenPopupArgs& args, OpenPopupAction action) {};

In order to unregister the callback, use the reset() method:

browser->onOpenPopup.reset();

onPrompt

Delegate<PromptArgs, PromptAction> molybden::BrowserDelegates::onPrompt

Invoked when the JavaScript dialog prompting the user to input some text should be displayed.

Use the following approach to register a callback:

browser->onPrompt = [](const PromptArgs& args, PromptAction action) {};

In order to unregister the callback, use the reset() method:

browser->onPrompt.reset();

onRequestPdfPassword

Delegate<RequestPdfPasswordArgs, RequestPdfPasswordAction> molybden::BrowserDelegates::onRequestPdfPassword

Invoked when a web page needs a password to open an encrypted PDF document.

Use the following approach to register a callback:

browser->onRequestPdfPassword = [](const RequestPdfPasswordArgs& args, RequestPdfPasswordAction action) {};

In order to unregister the callback, use the reset() method:

browser->onRequestPdfPassword.reset();

onSaveAsPdf

Delegate<SaveAsPdfArgs, SaveAsPdfAction> molybden::BrowserDelegates::onSaveAsPdf

Invoked when the currently loaded web page is about to save as PDF document and the browser wants to display a file chooser dialog to ask the end user where to save the PDF file.

Use the following approach to register a callback:

browser->onSaveAsPdf = [](const SaveAsPdfArgs& args, SaveAsPdfAction action) {};

In order to unregister the callback, use the reset() method:

browser->onSaveAsPdf.reset();

onSaveCreditCard

Delegate<SaveCreditCardArgs, SaveCreditCardAction> molybden::BrowserDelegates::onSaveCreditCard

Invoked when user is prompted to save the credit card credentials in the credit card store after web form submission.

It happens when user submits a web form with credit card information (a cardholder name, number, expiration date, CVV/CVC).

Use the following approach to register a callback:

browser->onSaveCreditCard = [](const SaveCreditCardArgs& args, SaveCreditCardAction action) {};

In order to unregister the callback, use the reset() method:

browser->onSaveCreditCard.reset();

onSavePassword

Delegate<SavePasswordArgs, SavePasswordAction> molybden::BrowserDelegates::onSavePassword

Invoked when the the user is prompted to save the password credentials in the password store after web form submission.

Use the following approach to register a callback:

browser->onSavePassword = [](const SavePasswordArgs& args, SavePasswordAction action) {};

In order to unregister the callback, use the reset() method:

browser->onSavePassword.reset();

onSaveUserProfile

Delegate<SaveUserProfileArgs, SaveUserProfileAction> molybden::BrowserDelegates::onSaveUserProfile

Invoked when user is prompted to save the user profile in the user profile store after web form submission.

It happens when user submits a web form with the fields associated with a user profile such as city, state, street, zip code, email address, etc.

Use the following approach to register a callback:

browser->onSaveUserProfile = [](const SaveUserProfileArgs& args, SaveUserProfileAction action) {};

In order to unregister the callback, use the reset() method:

browser->onSaveUserProfile.reset();

onShowContextMenu

Delegate<ShowContextMenuArgs, ShowContextMenuAction> molybden::BrowserDelegates::onShowContextMenu

Invoked when context menu on the loaded web page should be shown.

Use the following approach to register a callback:

browser->onShowContextMenu = [](const ShowContextMenuArgs& args, ShowContextMenuAction action) {};

In order to unregister the callback, use the reset() method:

browser->onShowContextMenu.reset();

onStartCaptureSession

Delegate<StartCaptureSessionArgs, StartCaptureSessionAction> molybden::BrowserDelegates::onStartCaptureSession

Invoked when a web page requests permission to start a capture session.

Use the following approach to register a callback:

browser->onStartCaptureSession = [](const StartCaptureSessionArgs& args, StartCaptureSessionAction action) {};

In order to unregister the callback, use the reset() method:

browser->onStartCaptureSession.reset();

onStartDownload

Delegate<StartDownloadArgs, StartDownloadAction> molybden::BrowserDelegates::onStartDownload

Invoked when the browser is about to start downloading a file.

Use the following approach to register a callback:

browser->onStartDownload = [](const StartDownloadArgs& args, StartDownloadAction action) {};

In order to unregister the callback, use the reset() method:

browser->onStartDownload.reset();

onUpdatePassword

Delegate<UpdatePasswordArgs, UpdatePasswordAction> molybden::BrowserDelegates::onUpdatePassword

Invoked when the the user is prompted to update the password credentials in the password store after web form submission.

Use the following approach to register a callback:

browser->onUpdatePassword = [](const UpdatePasswordArgs& args, UpdatePasswordAction action) {};

In order to unregister the callback, use the reset() method:

browser->onUpdatePassword.reset();

onUpdateUserProfile

Delegate<UpdateUserProfileArgs, UpdateUserProfileAction> molybden::BrowserDelegates::onUpdateUserProfile

Invoked when user is prompted to update the user profile in the user profile store after web form submission.

It happens when user changes the already saved user email address.

Use the following approach to register a callback:

browser->onUpdateUserProfile = [](const UpdateUserProfileArgs& args, UpdateUserProfileAction action) {};

In order to unregister the callback, use the reset() method:

browser->onUpdateUserProfile.reset();

onVerifyCert

Delegate<VerifyCertArgs, VerifyCertAction> molybden::BrowserDelegates::onVerifyCert

Invoked when certificate verification is required.

Use the following approach to register a callback:

browser->onVerifyCert = [](const VerifyCertArgs& args, VerifyCertAction action) {};

In order to unregister the callback, use the reset() method:

browser->onVerifyCert.reset();

---

The documentation for this class was generated from the following file:

• include/molybden/browser/browser_delegates.hpp