Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/shyiko/electron-har
A command-line tool for generating HTTP Archive (HAR) (based on Electron)
https://github.com/shyiko/electron-har
Last synced: 2 months ago
JSON representation
A command-line tool for generating HTTP Archive (HAR) (based on Electron)
- Host: GitHub
- URL: https://github.com/shyiko/electron-har
- Owner: shyiko
- License: mit
- Created: 2015-12-09T23:58:28.000Z (about 9 years ago)
- Default Branch: master
- Last Pushed: 2018-12-18T06:07:20.000Z (about 6 years ago)
- Last Synced: 2024-08-10T10:50:51.917Z (5 months ago)
- Language: JavaScript
- Homepage: https://www.npmjs.com/package/electron-har
- Size: 72.3 KB
- Stars: 47
- Watchers: 8
- Forks: 11
- Open Issues: 8
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-electron-zh - electron-har - Command-line tool for generating HTTP Archive (HAR). (Tools / Using Electron)
README
# electron-har
A command-line tool for generating [HTTP Archive (HAR)](http://www.softwareishard.com/blog/har-12-spec/) (based on [Electron](http://electron.atom.io/)).
The data you get is identical to "Chromium -> Developer Tools -> Network pane -> Save All as HAR".
## Installation
Prebuilt binaries can be found on the [release(s)](https://github.com/shyiko/electron-har/releases) page.
You can also use [npm](https://www.npmjs.com/):
```sh
npm install -g electron-har
```
> In order for Electron to work on Debian/Ubuntu (specifically on Debian 8/Ubuntu 12.04)
following packages have to be installed `libgtk2.0-0 libgconf-2-4 libasound2 libxtst6 libxss1 libnss3`.
## Usage
> **NOTE** for Linux users: you might need to --disable-gpu
```sh
# NOTE: on Linux --disable-gpu might be needed
electron-har http://google.com # writes HAR to stdout
# in case something doesn't look right / not working
ELECTRON_ENABLE_LOGGING=1 electron-har --disable-gpu --show http://google.com 2>electron.log
# in a headless environment (CI agent on Linux?) - xvfb-run will do just fine
DISPLAY=:1 xvfb-run electron-har http://google.com -o google_com.har
# to see a complete list of command line options
electron-har --help
```
... or **pragmatically**
```js
const electronHAR = require('electron-har')
electronHAR('http://enterprise.com/self-destruct', {
user: {
name: 'jean_luc_picard',
password: 'picard_4_7_alpha_tango'
}
}, function (err, json) {
if (err) {
throw err
}
console.log(json.log.entries)
})
```
In a headless environment you might want to use [kesla/headless](https://github.com/kesla/node-headless) (which will start Xvfb for you).
```js
const headless = require('headless')
const electronHAR = require('electron-har')
(function (cb) {
if (!process.env.DISPLAY) {
headless(function (err, proc, display) {
if (err) {
return cb(err)
}
process.env.DISPLAY = ':' + display
cb(null, proc)
})
} else {
process.nextTick(cb)
}
})(function (err, xvfb) {
if (err) {
throw err
}
electronHAR(..., function (err, json) {
...
xvfb && xvfb.kill()
})
})
```
## License
[MIT License](https://github.com/shyiko/electron-har/blob/master/LICENSE)