// ************************************************************************ // ***************************** CEF4Delphi ******************************* // ************************************************************************ // // CEF4Delphi is based on DCEF3 which uses CEF to embed a chromium-based // browser in Delphi applications. // // The original license of DCEF3 still applies to CEF4Delphi. // // For more information about CEF4Delphi visit : // https://www.briskbard.com/index.php?lang=en&pageid=cef // // Copyright © 2020 Salvador Diaz Fau. All rights reserved. // // ************************************************************************ // ************ vvvv Original license and comments below vvvv ************* // ************************************************************************ (* * Delphi Chromium Embedded 3 * * Usage allowed under the restrictions of the Lesser GNU General Public License * or alternatively the restrictions of the Mozilla Public License 1.1 * * Software distributed under the License is distributed on an "AS IS" basis, * WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License for * the specific language governing rights and limitations under the License. * * Unit owner : Henri Gourvest * Web site : http://www.progdigy.com * Repository : http://code.google.com/p/delphichromiumembedded/ * Group : http://groups.google.com/group/delphichromiumembedded * * Embarcadero Technologies, Inc is not permitted to use or redistribute * this source code without explicit permission. * *) unit uDOMVisitor; {$I cef.inc} interface uses {$IFDEF DELPHI16_UP} Winapi.Windows, Winapi.Messages, System.SysUtils, System.Variants, System.Classes, Vcl.Graphics, Vcl.Menus, Vcl.Controls, Vcl.Forms, Vcl.Dialogs, Vcl.StdCtrls, Vcl.ExtCtrls, System.Types, Vcl.ComCtrls, Vcl.ClipBrd, System.UITypes, {$ELSE} Windows, Messages, SysUtils, Variants, Classes, Graphics, Menus, Controls, Forms, Dialogs, StdCtrls, ExtCtrls, Types, ComCtrls, ClipBrd, {$ENDIF} uCEFChromium, uCEFWindowParent, uCEFInterfaces, uCEFApplication, uCEFTypes, uCEFConstants, uCEFWinControl, uCEFSentinel, uCEFChromiumCore; const MINIBROWSER_VISITDOM_PARTIAL = WM_APP + $101; MINIBROWSER_VISITDOM_FULL = WM_APP + $102; MINIBROWSER_COPYFRAMEIDS_1 = WM_APP + $103; MINIBROWSER_COPYFRAMEIDS_2 = WM_APP + $104; MINIBROWSER_CONTEXTMENU_VISITDOM_PARTIAL = MENU_ID_USER_FIRST + 1; MINIBROWSER_CONTEXTMENU_VISITDOM_FULL = MENU_ID_USER_FIRST + 2; MINIBROWSER_CONTEXTMENU_COPYFRAMEIDS_1 = MENU_ID_USER_FIRST + 3; MINIBROWSER_CONTEXTMENU_COPYFRAMEIDS_2 = MENU_ID_USER_FIRST + 4; DOMVISITOR_MSGNAME_PARTIAL = 'domvisitorpartial'; DOMVISITOR_MSGNAME_FULL = 'domvisitorfull'; RETRIEVEDOM_MSGNAME_PARTIAL = 'retrievedompartial'; RETRIEVEDOM_MSGNAME_FULL = 'retrievedomfull'; FRAMEIDS_MSGNAME = 'getframeids'; type TDOMVisitorFrm = class(TForm) CEFWindowParent1: TCEFWindowParent; Chromium1: TChromium; AddressBarPnl: TPanel; AddressEdt: TEdit; StatusBar1: TStatusBar; Timer1: TTimer; Panel1: TPanel; GoBtn: TButton; VisitDOMBtn: TButton; procedure GoBtnClick(Sender: TObject); procedure FormShow(Sender: TObject); procedure Chromium1AfterCreated(Sender: TObject; const browser: ICefBrowser); procedure Chromium1BeforeContextMenu(Sender: TObject; const browser: ICefBrowser; const frame: ICefFrame; const params: ICefContextMenuParams; const model: ICefMenuModel); procedure Chromium1ContextMenuCommand(Sender: TObject; const browser: ICefBrowser; const frame: ICefFrame; const params: ICefContextMenuParams; commandId: Integer; eventFlags: Cardinal; out Result: Boolean); procedure Chromium1ProcessMessageReceived(Sender: TObject; const browser: ICefBrowser; const frame: ICefFrame; sourceProcess: TCefProcessId; const message: ICefProcessMessage; out Result: Boolean); procedure Timer1Timer(Sender: TObject); procedure VisitDOMBtnClick(Sender: TObject); procedure Chromium1BeforePopup(Sender: TObject; const browser: ICefBrowser; const frame: ICefFrame; const targetUrl, targetFrameName: ustring; targetDisposition: TCefWindowOpenDisposition; userGesture: Boolean; const popupFeatures: TCefPopupFeatures; var windowInfo: TCefWindowInfo; var client: ICefClient; var settings: TCefBrowserSettings; var extra_info: ICefDictionaryValue; var noJavascriptAccess: Boolean; var Result: Boolean); procedure FormCreate(Sender: TObject); procedure FormCloseQuery(Sender: TObject; var CanClose: Boolean); procedure Chromium1Close(Sender: TObject; const browser: ICefBrowser; var aAction : TCefCloseBrowserAction); procedure Chromium1BeforeClose(Sender: TObject; const browser: ICefBrowser); private { Private declarations } protected // Variables to control when can we destroy the form safely FCanClose : boolean; // Set to True in TChromium.OnBeforeClose FClosing : boolean; // Set to True in the CloseQuery event. procedure BrowserCreatedMsg(var aMessage : TMessage); message CEF_AFTERCREATED; procedure BrowserDestroyMsg(var aMessage : TMessage); message CEF_DESTROY; procedure VisitDOMMsg(var aMessage : TMessage); message MINIBROWSER_VISITDOM_PARTIAL; procedure VisitDOM2Msg(var aMessage : TMessage); message MINIBROWSER_VISITDOM_FULL; procedure CopyFrameIDs1(var aMessage : TMessage); message MINIBROWSER_COPYFRAMEIDS_1; procedure CopyFrameIDs2(var aMessage : TMessage); message MINIBROWSER_COPYFRAMEIDS_2; procedure WMMove(var aMessage : TWMMove); message WM_MOVE; procedure WMMoving(var aMessage : TMessage); message WM_MOVING; procedure ShowStatusText(const aText : string); public { Public declarations } end; var DOMVisitorFrm: TDOMVisitorFrm; procedure CreateGlobalCEFApp; implementation {$R *.dfm} uses uCEFProcessMessage, uCEFMiscFunctions, uCEFSchemeRegistrar, uCEFRenderProcessHandler, uCEFv8Handler, uCEFDomVisitor, uCEFDomNode, uCEFTask; // This demo sends messages from the browser process to the render process, // and from the render process to the browser process. // To send a message from the browser process you must use the TChromium.SendProcessMessage // procedure with a PID_RENDERER parameter. The render process receives those messages in // the GlobalCEFApp.OnProcessMessageReceived event. // To send messages from the render process you must use the frame.SendProcessMessage // procedure with a PID_BROWSER parameter. The browser process receives those messages in // the TChromium.OnProcessMessageReceived event. // message.name is used to identify different messages sent with SendProcessMessage. // The OnProcessMessageReceived event can recognize any number of messages identifying them // by message.name // Destruction steps // ================= // 1. FormCloseQuery sets CanClose to FALSE calls TChromium.CloseBrowser which triggers the TChromium.OnClose event. // 2. TChromium.OnClose sends a CEFBROWSER_DESTROY message to destroy CEFWindowParent1 in the main thread, which triggers the TChromium.OnBeforeClose event. // 3. TChromium.OnBeforeClose sets FCanClose := True and sends WM_CLOSE to the form. procedure SimpleDOMIteration(const aDocument: ICefDomDocument); var TempHead, TempChild : ICefDomNode; begin try if (aDocument <> nil) then begin TempHead := aDocument.Head; if (TempHead <> nil) then begin TempChild := TempHead.FirstChild; while (TempChild <> nil) do begin CefLog('CEF4Delphi', 1, CEF_LOG_SEVERITY_ERROR, 'Head child element : ' + TempChild.Name); TempChild := TempChild.NextSibling; end; end; end; except on e : exception do if CustomExceptionHandler('SimpleDOMIteration', e) then raise; end; end; procedure SimpleNodeSearch(const aDocument: ICefDomDocument); const NODE_ID = 'lst-ib'; // input box node found in google.com homepage var TempNode : ICefDomNode; begin try if (aDocument <> nil) then begin TempNode := aDocument.GetElementById(NODE_ID); if (TempNode <> nil) then begin CefLog('CEF4Delphi', 1, CEF_LOG_SEVERITY_ERROR, NODE_ID + ' element name : ' + TempNode.Name); CefLog('CEF4Delphi', 1, CEF_LOG_SEVERITY_ERROR, NODE_ID + ' element value : ' + TempNode.GetValue); end; TempNode := aDocument.GetFocusedNode; if (TempNode <> nil) then begin CefLog('CEF4Delphi', 1, CEF_LOG_SEVERITY_ERROR, 'Focused element name : ' + TempNode.Name); CefLog('CEF4Delphi', 1, CEF_LOG_SEVERITY_ERROR, 'Focused element inner text : ' + TempNode.ElementInnerText); end; end; except on e : exception do if CustomExceptionHandler('SimpleNodeSearch', e) then raise; end; end; procedure DOMVisitor_OnDocAvailable(const browser: ICefBrowser; const frame: ICefFrame; const document: ICefDomDocument); var TempMessage : ICefProcessMessage; begin // This function is called from a different process. // document is only valid inside this function. // As an example, this function only writes the document title to the 'debug.log' file. CefLog('CEF4Delphi', 1, CEF_LOG_SEVERITY_ERROR, 'document.Title : ' + document.Title); if document.HasSelection then CefLog('CEF4Delphi', 1, CEF_LOG_SEVERITY_ERROR, 'document.SelectionAsText : ' + quotedstr(document.SelectionAsText)) else CefLog('CEF4Delphi', 1, CEF_LOG_SEVERITY_ERROR, 'document.HasSelection : False'); // Simple DOM iteration example SimpleDOMIteration(document); // Simple DOM searches SimpleNodeSearch(document); // Sending back some custom results to the browser process // Notice that the DOMVISITOR_MSGNAME_PARTIAL message name needs to be recognized in // Chromium1ProcessMessageReceived try TempMessage := TCefProcessMessageRef.New(DOMVISITOR_MSGNAME_PARTIAL); TempMessage.ArgumentList.SetString(0, 'document.Title : ' + document.Title); if (frame <> nil) and frame.IsValid then frame.SendProcessMessage(PID_BROWSER, TempMessage); finally TempMessage := nil; end; end; procedure DOMVisitor_OnDocAvailableFullMarkup(const browser: ICefBrowser; const frame: ICefFrame; const document: ICefDomDocument); var TempMessage : ICefProcessMessage; begin // Sending back some custom results to the browser process // Notice that the DOMVISITOR_MSGNAME_FULL message name needs to be recognized in // Chromium1ProcessMessageReceived try TempMessage := TCefProcessMessageRef.New(DOMVISITOR_MSGNAME_FULL); TempMessage.ArgumentList.SetString(0, document.Body.AsMarkup); if (frame <> nil) and frame.IsValid then frame.SendProcessMessage(PID_BROWSER, TempMessage); finally TempMessage := nil; end; end; procedure DOMVisitor_GetFrameIDs(const browser: ICefBrowser; const frame : ICefFrame); var i : NativeUInt; TempCount : NativeUInt; TempArray : TCefFrameIdentifierArray; TempString : string; TempMsg : ICefProcessMessage; begin TempCount := browser.FrameCount; if browser.GetFrameIdentifiers(TempCount, TempArray) then begin TempString := ''; i := 0; while (i < TempCount) do begin TempString := TempString + inttostr(TempArray[i]) + CRLF; inc(i); end; try TempMsg := TCefProcessMessageRef.New(FRAMEIDS_MSGNAME); TempMsg.ArgumentList.SetString(0, TempString); if (frame <> nil) and frame.IsValid then frame.SendProcessMessage(PID_BROWSER, TempMsg); finally TempMsg := nil; end; end; end; procedure GlobalCEFApp_OnProcessMessageReceived(const browser : ICefBrowser; const frame : ICefFrame; sourceProcess : TCefProcessId; const message : ICefProcessMessage; var aHandled : boolean); var TempVisitor : TCefFastDomVisitor2; begin aHandled := False; if (browser <> nil) then begin if (message.name = RETRIEVEDOM_MSGNAME_PARTIAL) then begin if (frame <> nil) and frame.IsValid then begin TempVisitor := TCefFastDomVisitor2.Create(browser, frame, DOMVisitor_OnDocAvailable); frame.VisitDom(TempVisitor); end; aHandled := True; end else if (message.name = RETRIEVEDOM_MSGNAME_FULL) then begin if (frame <> nil) and frame.IsValid then begin TempVisitor := TCefFastDomVisitor2.Create(browser, frame, DOMVisitor_OnDocAvailableFullMarkup); frame.VisitDom(TempVisitor); end; aHandled := True; end else if (message.name = FRAMEIDS_MSGNAME) then begin DOMVisitor_GetFrameIDs(browser, frame); aHandled := True; end; end; end; procedure CreateGlobalCEFApp; begin GlobalCEFApp := TCefApplication.Create; GlobalCEFApp.RemoteDebuggingPort := 9000; GlobalCEFApp.OnProcessMessageReceived := GlobalCEFApp_OnProcessMessageReceived; // Enabling the debug log file for then DOM visitor demo. // This adds lots of warnings to the console, specially if you run this inside VirtualBox. // Remove it if you don't want to use the DOM visitor GlobalCEFApp.LogFile := 'debug.log'; GlobalCEFApp.LogSeverity := LOGSEVERITY_INFO; end; procedure TDOMVisitorFrm.Chromium1AfterCreated(Sender: TObject; const browser: ICefBrowser); begin PostMessage(Handle, CEF_AFTERCREATED, 0, 0); end; procedure TDOMVisitorFrm.Chromium1BeforeClose(Sender: TObject; const browser: ICefBrowser); begin FCanClose := True; PostMessage(Handle, WM_CLOSE, 0, 0); end; procedure TDOMVisitorFrm.Chromium1BeforeContextMenu(Sender: TObject; const browser: ICefBrowser; const frame: ICefFrame; const params: ICefContextMenuParams; const model: ICefMenuModel); begin model.AddItem(MINIBROWSER_CONTEXTMENU_VISITDOM_PARTIAL, 'Visit DOM in CEF (only Title)'); model.AddItem(MINIBROWSER_CONTEXTMENU_VISITDOM_FULL, 'Visit DOM in CEF (BODY HTML)'); model.AddItem(MINIBROWSER_CONTEXTMENU_COPYFRAMEIDS_1, 'Copy frame IDs in the browser process'); model.AddItem(MINIBROWSER_CONTEXTMENU_COPYFRAMEIDS_2, 'Copy frame IDs in the render process'); end; procedure TDOMVisitorFrm.Chromium1BeforePopup(Sender: TObject; const browser: ICefBrowser; const frame: ICefFrame; const targetUrl, targetFrameName: ustring; targetDisposition: TCefWindowOpenDisposition; userGesture: Boolean; const popupFeatures: TCefPopupFeatures; var windowInfo: TCefWindowInfo; var client: ICefClient; var settings: TCefBrowserSettings; var extra_info: ICefDictionaryValue; var noJavascriptAccess: Boolean; var Result: Boolean); begin // For simplicity, this demo blocks all popup windows and new tabs Result := (targetDisposition in [WOD_NEW_FOREGROUND_TAB, WOD_NEW_BACKGROUND_TAB, WOD_NEW_POPUP, WOD_NEW_WINDOW]); end; procedure TDOMVisitorFrm.Chromium1Close(Sender: TObject; const browser: ICefBrowser; var aAction : TCefCloseBrowserAction); begin PostMessage(Handle, CEF_DESTROY, 0, 0); aAction := cbaDelay; end; procedure TDOMVisitorFrm.Chromium1ContextMenuCommand(Sender: TObject; const browser: ICefBrowser; const frame: ICefFrame; const params: ICefContextMenuParams; commandId: Integer; eventFlags: Cardinal; out Result: Boolean); begin Result := False; case commandId of MINIBROWSER_CONTEXTMENU_VISITDOM_PARTIAL : PostMessage(Handle, MINIBROWSER_VISITDOM_PARTIAL, 0, 0); MINIBROWSER_CONTEXTMENU_VISITDOM_FULL : PostMessage(Handle, MINIBROWSER_VISITDOM_FULL, 0, 0); MINIBROWSER_CONTEXTMENU_COPYFRAMEIDS_1 : PostMessage(Handle, MINIBROWSER_COPYFRAMEIDS_1, 0, 0); MINIBROWSER_CONTEXTMENU_COPYFRAMEIDS_2 : PostMessage(Handle, MINIBROWSER_COPYFRAMEIDS_2, 0, 0); end; end; procedure TDOMVisitorFrm.Chromium1ProcessMessageReceived(Sender: TObject; const browser: ICefBrowser; const frame: ICefFrame; sourceProcess: TCefProcessId; const message: ICefProcessMessage; out Result: Boolean); begin Result := False; if (message = nil) or (message.ArgumentList = nil) then exit; // Message received from the DOMVISITOR in CEF if (message.Name = DOMVISITOR_MSGNAME_PARTIAL) then begin ShowStatusText('DOM Visitor result text : ' + message.ArgumentList.GetString(0)); Result := True; end else if (message.Name = DOMVISITOR_MSGNAME_FULL) then begin Clipboard.AsText := message.ArgumentList.GetString(0); ShowStatusText('HTML copied to the clipboard'); Result := True; end else if (message.Name = FRAMEIDS_MSGNAME) then begin Clipboard.AsText := message.ArgumentList.GetString(0); ShowStatusText('Frame IDs copied to the clipboard in the render process.'); Result := True; end; end; procedure TDOMVisitorFrm.FormCloseQuery(Sender: TObject; var CanClose: Boolean); begin CanClose := FCanClose; if not(FClosing) then begin FClosing := True; Visible := False; Chromium1.CloseBrowser(True); end; end; procedure TDOMVisitorFrm.FormCreate(Sender: TObject); begin FCanClose := False; FClosing := False; end; procedure TDOMVisitorFrm.FormShow(Sender: TObject); begin // GlobalCEFApp.GlobalContextInitialized has to be TRUE before creating any browser // If it's not initialized yet, we use a simple timer to create the browser later. if not(Chromium1.CreateBrowser(CEFWindowParent1, '')) then Timer1.Enabled := True; end; procedure TDOMVisitorFrm.GoBtnClick(Sender: TObject); begin Chromium1.LoadURL(AddressEdt.Text); end; procedure TDOMVisitorFrm.BrowserCreatedMsg(var aMessage : TMessage); begin CEFWindowParent1.UpdateSize; AddressBarPnl.Enabled := True; GoBtn.Click; end; procedure TDOMVisitorFrm.BrowserDestroyMsg(var aMessage : TMessage); begin CEFWindowParent1.Free; end; procedure TDOMVisitorFrm.VisitDOMBtnClick(Sender: TObject); begin PostMessage(Handle, MINIBROWSER_VISITDOM_PARTIAL, 0, 0); end; procedure TDOMVisitorFrm.VisitDOMMsg(var aMessage : TMessage); var TempMsg : ICefProcessMessage; begin // Use the ArgumentList property if you need to pass some parameters. TempMsg := TCefProcessMessageRef.New(RETRIEVEDOM_MSGNAME_PARTIAL); // Same name than TCefCustomRenderProcessHandler.MessageName Chromium1.SendProcessMessage(PID_RENDERER, TempMsg); end; procedure TDOMVisitorFrm.VisitDOM2Msg(var aMessage : TMessage); var TempMsg : ICefProcessMessage; begin // Use the ArgumentList property if you need to pass some parameters. TempMsg := TCefProcessMessageRef.New(RETRIEVEDOM_MSGNAME_FULL); // Same name than TCefCustomRenderProcessHandler.MessageName Chromium1.SendProcessMessage(PID_RENDERER, TempMsg); end; procedure TDOMVisitorFrm.CopyFrameIDs1(var aMessage : TMessage); var i : NativeUInt; TempCount : NativeUInt; TempArray : TCefFrameIdentifierArray; TempString : string; begin TempCount := Chromium1.FrameCount; if Chromium1.GetFrameIdentifiers(TempCount, TempArray) then begin TempString := ''; i := 0; while (i < TempCount) do begin TempString := TempString + inttostr(TempArray[i]) + CRLF; inc(i); end; clipboard.AsText := TempString; ShowStatusText('Frame IDs copied to the clipboard in the browser process (' + inttostr(TempCount) + ')'); end; end; procedure TDOMVisitorFrm.CopyFrameIDs2(var aMessage : TMessage); var TempMsg : ICefProcessMessage; begin TempMsg := TCefProcessMessageRef.New(FRAMEIDS_MSGNAME); Chromium1.SendProcessMessage(PID_RENDERER, TempMsg); end; procedure TDOMVisitorFrm.WMMove(var aMessage : TWMMove); begin inherited; if (Chromium1 <> nil) then Chromium1.NotifyMoveOrResizeStarted; end; procedure TDOMVisitorFrm.WMMoving(var aMessage : TMessage); begin inherited; if (Chromium1 <> nil) then Chromium1.NotifyMoveOrResizeStarted; end; procedure TDOMVisitorFrm.ShowStatusText(const aText : string); begin StatusBar1.Panels[0].Text := aText; end; procedure TDOMVisitorFrm.Timer1Timer(Sender: TObject); begin Timer1.Enabled := False; if not(Chromium1.CreateBrowser(CEFWindowParent1, '')) and not(Chromium1.Initialized) then Timer1.Enabled := True; end; end.