2016-11-10 20:25:26 +00:00
|
|
|
## Class: BrowserWindowProxy
|
|
|
|
|
|
|
|
> Manipulate the child browser window
|
|
|
|
|
2021-06-15 20:50:31 +00:00
|
|
|
Process: [Renderer](../glossary.md#renderer-process)<br />
|
|
|
|
_This class is not exported from the `'electron'` module. It is only available as a return value of other methods in the Electron API._
|
2016-11-10 20:25:26 +00:00
|
|
|
|
|
|
|
The `BrowserWindowProxy` object is returned from `window.open` and provides
|
|
|
|
limited functionality with the child window.
|
|
|
|
|
|
|
|
### Instance Methods
|
|
|
|
|
|
|
|
The `BrowserWindowProxy` object has the following instance methods:
|
|
|
|
|
|
|
|
#### `win.blur()`
|
|
|
|
|
|
|
|
Removes focus from the child window.
|
|
|
|
|
|
|
|
#### `win.close()`
|
|
|
|
|
|
|
|
Forcefully closes the child window without calling its unload event.
|
|
|
|
|
|
|
|
#### `win.eval(code)`
|
|
|
|
|
|
|
|
* `code` String
|
|
|
|
|
|
|
|
Evaluates the code in the child window.
|
|
|
|
|
|
|
|
#### `win.focus()`
|
|
|
|
|
|
|
|
Focuses the child window (brings the window to front).
|
|
|
|
|
|
|
|
#### `win.print()`
|
|
|
|
|
|
|
|
Invokes the print dialog on the child window.
|
|
|
|
|
|
|
|
#### `win.postMessage(message, targetOrigin)`
|
|
|
|
|
2019-07-08 23:43:49 +00:00
|
|
|
* `message` any
|
2016-11-10 20:25:26 +00:00
|
|
|
* `targetOrigin` String
|
|
|
|
|
|
|
|
Sends a message to the child window with the specified origin or `*` for no
|
|
|
|
origin preference.
|
|
|
|
|
|
|
|
In addition to these methods, the child window implements `window.opener` object
|
|
|
|
with no properties and a single method.
|
|
|
|
|
|
|
|
### Instance Properties
|
|
|
|
|
|
|
|
The `BrowserWindowProxy` object has the following instance properties:
|
|
|
|
|
|
|
|
#### `win.closed`
|
|
|
|
|
2017-07-24 08:29:03 +00:00
|
|
|
A `Boolean` that is set to true after the child window gets closed.
|