electron-api-docs

Electron's API documentation in a structured JSON format.

Usage no npm install needed!

<script type="module">
  import electronApiDocs from 'https://cdn.skypack.dev/electron-api-docs';
</script>

README

electron-api-docs Build Status

Electron's API documentation in a structured JSON format.

Installation

npm install electron-api-docs --save

Or take it for a spin in your Node.js REPL:

npm i -g trymodule && trymodule electron-api-docs=apis

Note: This package is not semantically versioned. It is published in step with Electron. When you install electron-api-docs@1.4.1, you're getting the API docs from Electron v1.4.1.

Usage

This module exports structured API data in a few different formats. Choose the one that works best for your use case:

Object Tree Structure

To access the docs as a big object tree:

const apis = require('electron-api-docs/tree')

This gives you an object with keys for easy traversal:

apis.BrowserWindow.instanceMethods.setAspectRatio

Array Structure

To access the docs as an array of API objects:

const apis = require('electron-api-docs/electron-api.json')

This gives you an array of API objects, so functional methods like find, map, filter, and every can be used:

apis.find(api => api.name === 'BrowserWindow')
apis.filter(api => api.type === 'Class')
apis.filter(api => api.type === 'Module')
apis.map(api => api.name)

Keyed Array Structure

For the best of both worlds (arrays and objects), you can require the module as a keyed array:

const apis = require('electron-api-docs')

When you require it, you get an array of API objects

apis.length
// => 33

The array has a key for each API name, for convenient access:

apis.BrowserWindow
apis.BrowserWindow.staticMethods.getAllWindows.description
apis.WebContents.instanceMethods.savePage.parameters.saveType.possibleValues
apis.app.events.quit

All of the arrays have named keys, but they're still actually arrays, so functional methods like find, map, filter, and every can be used:

apis.find(api => api.name === 'BrowserWindow')
apis.filter(api => api.type === 'Class')
apis.filter(api => api.type === 'Module')
apis.map(api => api.name)

// All arrays have named keys, not just the top-level array!
apis.BrowserWindow.instanceMethods.map(method => method.name)

Tests

npm install
npm test

Dependencies

  • keyed-array: Recursively add named keys to arrays of objects

Dev Dependencies

  • chai: BDD/TDD assertion library for node.js and the browser. Test framework agnostic.
  • gh-latest-release: Get the latest published full release for the Github repository
  • json: a 'json' command for massaging and processing JSON on the command line
  • mocha: simple, flexible, fun test framework
  • standard: JavaScript Standard Style
  • standard-markdown: Test your Markdown files for Standard JavaScript Style™

License

MIT