using ElectronNET.API.Entities; using Newtonsoft.Json; using Newtonsoft.Json.Linq; using Newtonsoft.Json.Serialization; using System; using System.Threading.Tasks; namespace ElectronNET.API { /// /// Render and control web pages. /// public class WebContents { /// /// Gets the identifier. /// /// /// The identifier. /// public int Id { get; private set; } /// /// Manage browser sessions, cookies, cache, proxy settings, etc. /// public Session Session { get; internal set; } /// /// Emitted when the renderer process crashes or is killed. /// public event Action OnCrashed { add { if (_crashed == null) { BridgeConnector.Socket.On("webContents-crashed" + Id, (killed) => { _crashed((bool)killed); }); BridgeConnector.Socket.Emit("register-webContents-crashed", Id); } _crashed += value; } remove { _crashed -= value; if (_crashed == null) BridgeConnector.Socket.Off("webContents-crashed" + Id); } } private event Action _crashed; /// /// Emitted when the navigation is done, i.e. the spinner of the tab has /// stopped spinning, and the onload event was dispatched. /// public event Action OnDidFinishLoad { add { if (_didFinishLoad == null) { BridgeConnector.Socket.On("webContents-didFinishLoad" + Id, () => { _didFinishLoad(); }); BridgeConnector.Socket.Emit("register-webContents-didFinishLoad", Id); } _didFinishLoad += value; } remove { _didFinishLoad -= value; if (_didFinishLoad == null) BridgeConnector.Socket.Off("webContents-didFinishLoad" + Id); } } private event Action _didFinishLoad; internal WebContents(int id) { Id = id; Session = new Session(id); } /// /// Opens the devtools. /// public void OpenDevTools() { BridgeConnector.Socket.Emit("webContentsOpenDevTools", Id); } /// /// Opens the devtools. /// /// public void OpenDevTools(OpenDevToolsOptions openDevToolsOptions) { BridgeConnector.Socket.Emit("webContentsOpenDevTools", Id, JObject.FromObject(openDevToolsOptions, _jsonSerializer)); } /// /// Get system printers. /// /// printers public Task GetPrintersAsync() { var taskCompletionSource = new TaskCompletionSource(); BridgeConnector.Socket.On("webContents-getPrinters-completed", (printers) => { BridgeConnector.Socket.Off("webContents-getPrinters-completed"); taskCompletionSource.SetResult(((Newtonsoft.Json.Linq.JArray)printers).ToObject()); }); BridgeConnector.Socket.Emit("webContents-getPrinters", Id); return taskCompletionSource.Task; } /// /// Prints window's web page. /// /// /// success public Task PrintAsync(PrintOptions options = null) { var taskCompletionSource = new TaskCompletionSource(); BridgeConnector.Socket.On("webContents-print-completed", (success) => { BridgeConnector.Socket.Off("webContents-print-completed"); taskCompletionSource.SetResult((bool)success); }); if(options == null) { BridgeConnector.Socket.Emit("webContents-print", Id, ""); } else { BridgeConnector.Socket.Emit("webContents-print", Id, JObject.FromObject(options, _jsonSerializer)); } return taskCompletionSource.Task; } /// /// Prints window's web page as PDF with Chromium's preview printing custom /// settings.The landscape will be ignored if @page CSS at-rule is used in the web page. /// By default, an empty options will be regarded as: Use page-break-before: always; /// CSS style to force to print to a new page. /// /// /// /// success public Task PrintToPDFAsync(string path, PrintToPDFOptions options = null) { var taskCompletionSource = new TaskCompletionSource(); BridgeConnector.Socket.On("webContents-printToPDF-completed", (success) => { BridgeConnector.Socket.Off("webContents-printToPDF-completed"); taskCompletionSource.SetResult((bool)success); }); if(options == null) { BridgeConnector.Socket.Emit("webContents-printToPDF", Id, "", path); } else { BridgeConnector.Socket.Emit("webContents-printToPDF", Id, JObject.FromObject(options, _jsonSerializer), path); } return taskCompletionSource.Task; } /// /// Is used to get the Url of the loaded page. /// It's usefull if a web-server redirects you and you need to know where it redirects. For instance, It's useful in case of Implicit Authorization. /// /// URL of the loaded page public Task GetUrl() { var taskCompletionSource = new TaskCompletionSource(); var eventString = "webContents-getUrl" + Id; BridgeConnector.Socket.On(eventString, (url) => { BridgeConnector.Socket.Off(eventString); taskCompletionSource.SetResult((string)url); }); BridgeConnector.Socket.Emit("webContents-getUrl", Id); return taskCompletionSource.Task; } /// /// The async method will resolve when the page has finished loading, /// and rejects if the page fails to load. /// /// A noop rejection handler is already attached, which avoids unhandled rejection /// errors. /// /// Loads the `url` in the window. The `url` must contain the protocol prefix, e.g. /// the `http://` or `file://`. If the load should bypass http cache then use the /// `pragma` header to achieve it. /// /// public Task LoadURLAsync(string url) { return LoadURLAsync(url, new LoadURLOptions()); } /// /// The async method will resolve when the page has finished loading, /// and rejects if the page fails to load. /// /// A noop rejection handler is already attached, which avoids unhandled rejection /// errors. /// /// Loads the `url` in the window. The `url` must contain the protocol prefix, e.g. /// the `http://` or `file://`. If the load should bypass http cache then use the /// `pragma` header to achieve it. /// /// /// public Task LoadURLAsync(string url, LoadURLOptions options) { var taskCompletionSource = new TaskCompletionSource(); BridgeConnector.Socket.On("webContents-loadURL-complete" + Id, () => { BridgeConnector.Socket.Off("webContents-loadURL-complete" + Id); BridgeConnector.Socket.Off("webContents-loadURL-error" + Id); taskCompletionSource.SetResult(null); }); BridgeConnector.Socket.On("webContents-loadURL-error" + Id, (error) => { BridgeConnector.Socket.Off("webContents-loadURL-error" + Id); taskCompletionSource.SetException(new InvalidOperationException(error.ToString())); }); BridgeConnector.Socket.Emit("webContents-loadURL", Id, url, JObject.FromObject(options, _jsonSerializer)); return taskCompletionSource.Task; } private JsonSerializer _jsonSerializer = new JsonSerializer() { ContractResolver = new CamelCasePropertyNamesContractResolver(), NullValueHandling = NullValueHandling.Ignore, DefaultValueHandling = DefaultValueHandling.Ignore }; } }