# electron-window

> Convenience methods for Electron windows.

Latest version **0.8.1** (published 2016-05-14) · MIT license · 0 weekly downloads

## Install

```sh
npm install electron-window
pnpm add electron-window
yarn add electron-window
bun add electron-window
```

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support; pre 1.0.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 0.8.1 |
| Published | 2016-05-14 |
| First published | 2015-05-22 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 1 |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 289 |
| Author | JP Richardson |
| Maintainers | jprichardson |
| Keywords | window, atom, atom-shell, electron, gui, electron-component |

## Links

- npm: https://www.npmjs.com/package/electron-window
- Repository: https://github.com/jprichardson/electron-window
- Issues: https://github.com/jprichardson/electron-window/issues
- npm.io page: https://npm.io/package/electron-window

## Dependencies (1)

- [is-electron-renderer](https://npm.io/package/is-electron-renderer.md) ^2.0.0

## Recent versions

- 0.8.1 (latest) — 2016-05-14
- 0.8.0 — 2016-05-11
- 0.7.0 — 2016-05-06
- 0.6.4 — 2016-04-08
- 0.6.3 — 2016-04-06
- 0.6.2 — 2015-12-11
- 0.6.1 — 2015-12-11
- 0.6.0 — 2015-08-27
- 0.5.0 — 2015-07-15
- 0.4.3 — 2015-07-13
- 0.4.2 — 2015-07-10
- 0.4.1 — 2015-07-10
- 0.4.0 — 2015-07-10
- 0.3.0 — 2015-05-27
- 0.2.1 — 2015-05-22
- … 3 more at https://npm.io/package/electron-window/versions

## README

electron-window
===============

Convenience methods for Electron windows.


Installation
------------

    npm i --save electron-window


Usage
-----

### TL;DR:

`electron-window` converts this:

```js
const { 
  app, 
  BrowserWindow 
} = require('electron')

const path = require('path')
const url = require('url')

// Keep a global reference of the window object, if you don't, the window will
// be closed automatically when the javascript object is GCed.
let mainWindow = null

app.on('ready', () => {
  mainWindow = new BrowserWindow({ width: 1000, height: 400, show: false })

  const someArgs = { data: 'hi' }
  const indexPath = path.resolve(__dirname, '..', 'weird-location', 'index.html')
  const indexUrl = url.format({
    protocol: 'file',
    pathname: indexPath,
    slashes: true,
    hash: encodeURIComponent(JSON.stringify(someArgs))
  })

  mainWindow.on('closed', () => {
    mainWindow = null
  })

  mainWindow.webContents.on('did-finish-load', () => {
    mainWindow.show()
    console.log('window is now visible!')
  })

  mainWindow.loadUrl(indexUrl)
})
```

to this:

```js
const { app } = require('electron')
const path = require('path')
const window = require('electron-window')

app.on('ready', () => {
  const mainWindow = window.createWindow({ width: 1000, height: 400 })
  const someArgs = { data: 'hi' }
  const indexPath = path.resolve(__dirname, '..', 'weird-location', 'index.html')
  
  mainWindow.showUrl(indexPath, someArgs, () => {
    console.log('window is now visible!')
  })
})
```


### API Methods

#### createWindow(options)

Class method that creates a new [BrowserWindow](https://github.com/atom/electron/blob/master/docs/api/browser-window.md) with
the following default `options`: `{ show: false }`. No need to worry about keeping a global reference
to prevent garbage collection, this is handled for you.


#### parseArgs()

Instance method to parse arguments in window. You would only need to call from your renderer preload script if you pass in
[`preload`](https://github.com/atom/electron/blob/master/docs/api/browser-window.md#new-browserwindowoptions).


#### showUrl(httpOrFileUrl, [argsForRenderer], [callback])

Instance method that shows the url. When the url is finished loading, the callback is returned. If the optional `argsForRenderer` is set
then `__args__` will be a global object for the page in the renderer process. This is a convenient way to pass
arguments from the main process to the renderer process.


#### unref()

Instance method to call if you ever want to remove the global reference. Should only need to be called if
[`destroy()`](https://github.com/atom/electron/blob/master/docs/api/browser-window.md#browserwindowdestroy) is ever called.
Most likely, you won't need to use this.


### API Properties

#### windows

Class property to get a reference to all windows created and their ids. This is in the form of an object where the keys are window ids, and the values are instances of `BrowserWindow`.



### Example

**main process**

```js
const window = require('electron-window')

const windowOptions = {
  width: 1000,
  height: 400
}

const mainWindow = window.createWindow(windowOptions)

// can access at window.__args__ from scripts
// ran from index.html
const args = {
  data: 'some secret data'
}

mainWindow.showUrl('index.html', args, () => {
  console.log('the window should be showing with the contents of the URL now')
})
```

**renderer process**

```js
// only call if `preload` is set in `windowOptions`
require('electron-window').parseArgs()

console.log(window.__args__)
// => Object {data: "some secret data"}
```


License
-------

MIT

---
_Source: https://npm.io/package/electron-window · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._