// Copyright (c) 2014 GitHub, Inc. // Use of this source code is governed by the MIT license that can be // found in the LICENSE file. #ifndef ATOM_BROWSER_API_ATOM_API_WEB_CONTENTS_H_ #define ATOM_BROWSER_API_ATOM_API_WEB_CONTENTS_H_ #include #include #include "atom/browser/api/frame_subscriber.h" #include "atom/browser/api/save_page_handler.h" #include "atom/browser/api/trackable_object.h" #include "atom/browser/common_web_contents_delegate.h" #include "content/common/cursors/webcursor.h" #include "content/public/browser/web_contents_observer.h" #include "content/public/common/favicon_url.h" #include "native_mate/handle.h" #include "ui/gfx/image/image.h" namespace blink { struct WebDeviceEmulationParams; } namespace brightray { class InspectableWebContents; } namespace content { class ResourceRequestBodyImpl; } namespace mate { class Arguments; class Dictionary; } namespace atom { struct SetSizeParams; class AtomBrowserContext; class WebViewGuestDelegate; namespace api { class WebContents : public mate::TrackableObject, public CommonWebContentsDelegate, public content::WebContentsObserver { public: enum Type { BACKGROUND_PAGE, // A DevTools extension background page. BROWSER_WINDOW, // Used by BrowserWindow. REMOTE, // Thin wrap around an existing WebContents. WEB_VIEW, // Used by . OFF_SCREEN, // Used for offscreen rendering }; // For node.js callback function type: function(error, buffer) using PrintToPDFCallback = base::Callback, v8::Local)>; // Create from an existing WebContents. static mate::Handle CreateFrom( v8::Isolate* isolate, content::WebContents* web_contents); static mate::Handle CreateFrom( v8::Isolate* isolate, content::WebContents* web_contents, Type type); // Create a new WebContents. static mate::Handle Create( v8::Isolate* isolate, const mate::Dictionary& options); static void BuildPrototype(v8::Isolate* isolate, v8::Local prototype); int64_t GetID() const; int GetProcessID() const; Type GetType() const; bool Equal(const WebContents* web_contents) const; void LoadURL(const GURL& url, const mate::Dictionary& options); void DownloadURL(const GURL& url); GURL GetURL() const; base::string16 GetTitle() const; bool IsLoading() const; bool IsLoadingMainFrame() const; bool IsWaitingForResponse() const; void Stop(); void ReloadIgnoringCache(); void GoBack(); void GoForward(); void GoToOffset(int offset); bool IsCrashed() const; void SetUserAgent(const std::string& user_agent, mate::Arguments* args); std::string GetUserAgent(); void InsertCSS(const std::string& css); bool SavePage(const base::FilePath& full_file_path, const content::SavePageType& save_type, const SavePageHandler::SavePageCallback& callback); void OpenDevTools(mate::Arguments* args); void CloseDevTools(); bool IsDevToolsOpened(); bool IsDevToolsFocused(); void ToggleDevTools(); void EnableDeviceEmulation(const blink::WebDeviceEmulationParams& params); void DisableDeviceEmulation(); void InspectElement(int x, int y); void InspectServiceWorker(); void HasServiceWorker(const base::Callback&); void UnregisterServiceWorker(const base::Callback&); void SetAudioMuted(bool muted); bool IsAudioMuted(); void Print(mate::Arguments* args); void SetEmbedder(const WebContents* embedder); // Print current page as PDF. void PrintToPDF(const base::DictionaryValue& setting, const PrintToPDFCallback& callback); // DevTools workspace api. void AddWorkSpace(mate::Arguments* args, const base::FilePath& path); void RemoveWorkSpace(mate::Arguments* args, const base::FilePath& path); // Editing commands. void Undo(); void Redo(); void Cut(); void Copy(); void Paste(); void PasteAndMatchStyle(); void Delete(); void SelectAll(); void Unselect(); void Replace(const base::string16& word); void ReplaceMisspelling(const base::string16& word); uint32_t FindInPage(mate::Arguments* args); void StopFindInPage(content::StopFindAction action); void ShowDefinitionForSelection(); void CopyImageAt(int x, int y); // Focus. void Focus(); bool IsFocused() const; void TabTraverse(bool reverse); // Send messages to browser. bool SendIPCMessage(bool all_frames, const base::string16& channel, const base::ListValue& args); // Send WebInputEvent to the page. void SendInputEvent(v8::Isolate* isolate, v8::Local input_event); // Subscribe to the frame updates. void BeginFrameSubscription(mate::Arguments* args); void EndFrameSubscription(); // Dragging native items. void StartDrag(const mate::Dictionary& item, mate::Arguments* args); // Captures the page with |rect|, |callback| would be called when capturing is // done. void CapturePage(mate::Arguments* args); // Methods for creating . void SetSize(const SetSizeParams& params); bool IsGuest() const; // Methods for offscreen rendering bool IsOffScreen() const; void OnPaint(const gfx::Rect& dirty_rect, const SkBitmap& bitmap); void StartPainting(); void StopPainting(); bool IsPainting() const; void SetFrameRate(int frame_rate); int GetFrameRate() const; void Invalidate(); // Callback triggered on permission response. void OnEnterFullscreenModeForTab(content::WebContents* source, const GURL& origin, bool allowed); // Create window with the given disposition. void OnCreateWindow( const GURL& target_url, const std::string& frame_name, WindowOpenDisposition disposition, const std::vector& features, const scoped_refptr& body); // Returns the web preferences of current WebContents. v8::Local GetWebPreferences(v8::Isolate* isolate); // Returns the owner window. v8::Local GetOwnerBrowserWindow(); // Properties. int32_t ID() const; v8::Local Session(v8::Isolate* isolate); content::WebContents* HostWebContents(); v8::Local DevToolsWebContents(v8::Isolate* isolate); v8::Local Debugger(v8::Isolate* isolate); protected: WebContents(v8::Isolate* isolate, content::WebContents* web_contents, Type type); WebContents(v8::Isolate* isolate, const mate::Dictionary& options); ~WebContents(); void InitWithSessionAndOptions(v8::Isolate* isolate, content::WebContents *web_contents, mate::Handle session, const mate::Dictionary& options); // content::WebContentsDelegate: bool DidAddMessageToConsole(content::WebContents* source, int32_t level, const base::string16& message, int32_t line_no, const base::string16& source_id) override; void WebContentsCreated(content::WebContents* source_contents, int opener_render_process_id, int opener_render_frame_id, const std::string& frame_name, const GURL& target_url, content::WebContents* new_contents) override; void AddNewContents(content::WebContents* source, content::WebContents* new_contents, WindowOpenDisposition disposition, const gfx::Rect& initial_rect, bool user_gesture, bool* was_blocked) override; content::WebContents* OpenURLFromTab( content::WebContents* source, const content::OpenURLParams& params) override; void BeforeUnloadFired(content::WebContents* tab, bool proceed, bool* proceed_to_fire_unload) override; void MoveContents(content::WebContents* source, const gfx::Rect& pos) override; void CloseContents(content::WebContents* source) override; void ActivateContents(content::WebContents* contents) override; void UpdateTargetURL(content::WebContents* source, const GURL& url) override; bool IsPopupOrPanel(const content::WebContents* source) const override; void HandleKeyboardEvent( content::WebContents* source, const content::NativeWebKeyboardEvent& event) override; bool PreHandleKeyboardEvent(content::WebContents* source, const content::NativeWebKeyboardEvent& event, bool* is_keyboard_shortcut) override; void EnterFullscreenModeForTab(content::WebContents* source, const GURL& origin) override; void ExitFullscreenModeForTab(content::WebContents* source) override; void RendererUnresponsive( content::WebContents* source, const content::WebContentsUnresponsiveState& unresponsive_state) override; void RendererResponsive(content::WebContents* source) override; bool HandleContextMenu(const content::ContextMenuParams& params) override; bool OnGoToEntryOffset(int offset) override; void FindReply(content::WebContents* web_contents, int request_id, int number_of_matches, const gfx::Rect& selection_rect, int active_match_ordinal, bool final_update) override; bool CheckMediaAccessPermission( content::WebContents* web_contents, const GURL& security_origin, content::MediaStreamType type) override; void RequestMediaAccessPermission( content::WebContents* web_contents, const content::MediaStreamRequest& request, const content::MediaResponseCallback& callback) override; void RequestToLockMouse( content::WebContents* web_contents, bool user_gesture, bool last_unlocked_by_target) override; std::unique_ptr RunBluetoothChooser( content::RenderFrameHost* frame, const content::BluetoothChooser::EventHandler& handler) override; // content::WebContentsObserver: void BeforeUnloadFired(const base::TimeTicks& proceed_time) override; void RenderViewCreated(content::RenderViewHost*) override; void RenderViewDeleted(content::RenderViewHost*) override; void RenderProcessGone(base::TerminationStatus status) override; void DocumentLoadedInFrame( content::RenderFrameHost* render_frame_host) override; void DidFinishLoad(content::RenderFrameHost* render_frame_host, const GURL& validated_url) override; void DidFailLoad(content::RenderFrameHost* render_frame_host, const GURL& validated_url, int error_code, const base::string16& error_description, bool was_ignored_by_handler) override; void DidStartLoading() override; void DidStopLoading() override; void DidGetResourceResponseStart( const content::ResourceRequestDetails& details) override; void DidGetRedirectForResourceRequest( const content::ResourceRedirectDetails& details) override; void DidFinishNavigation( content::NavigationHandle* navigation_handle) override; bool OnMessageReceived(const IPC::Message& message) override; void WebContentsDestroyed() override; void NavigationEntryCommitted( const content::LoadCommittedDetails& load_details) override; void TitleWasSet(content::NavigationEntry* entry, bool explicit_set) override; void DidUpdateFaviconURL( const std::vector& urls) override; void PluginCrashed(const base::FilePath& plugin_path, base::ProcessId plugin_pid) override; void MediaStartedPlaying(const MediaPlayerInfo& video_type, const MediaPlayerId& id) override; void MediaStoppedPlaying(const MediaPlayerInfo& video_type, const MediaPlayerId& id) override; void DidChangeThemeColor(SkColor theme_color) override; // brightray::InspectableWebContentsDelegate: void DevToolsReloadPage() override; // brightray::InspectableWebContentsViewDelegate: void DevToolsFocused() override; void DevToolsOpened() override; void DevToolsClosed() override; private: AtomBrowserContext* GetBrowserContext() const; uint32_t GetNextRequestId() { return ++request_id_; } // Called when we receive a CursorChange message from chromium. void OnCursorChange(const content::WebCursor& cursor); // Called when received a message from renderer. void OnRendererMessage(const base::string16& channel, const base::ListValue& args); // Called when received a synchronous message from renderer. void OnRendererMessageSync(const base::string16& channel, const base::ListValue& args, IPC::Message* message); v8::Global session_; v8::Global devtools_web_contents_; v8::Global debugger_; std::unique_ptr guest_delegate_; // The host webcontents that may contain this webcontents. WebContents* embedder_; // The type of current WebContents. Type type_; // Request id used for findInPage request. uint32_t request_id_; // Whether background throttling is disabled. bool background_throttling_; // Whether to enable devtools. bool enable_devtools_; DISALLOW_COPY_AND_ASSIGN(WebContents); }; } // namespace api } // namespace atom #endif // ATOM_BROWSER_API_ATOM_API_WEB_CONTENTS_H_