index.js

  1. 'use strict';
  3. /**
  4.  * Serializable value
  5.  *
  6.  * @typedef {number|boolean|string|object|array} Serializable
  7.  *
  8.  * @see     {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON/stringify#Description|Promise}
  9.  */
  11. /**
  12.  * A proxy of the return value in the future
  13.  *
  14.  * @typedef {Promise} Promise
  15.  *
  16.  * @see     {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise|Promise}
  17.  */
  19. /**
  20.  * Event emitter
  21.  *
  22.  * @typedef {EventEmitter} EventEmitter
  23.  *
  24.  * @see {@link https://nodejs.org/dist/latest-v6.x/docs/api/events.html#events_class_eventemitter|Node.JS - Event module}
  25.  */
  27. /**
  28.  * Binary buffer
  29.  *
  30.  * @typedef {Buffer} Buffer
  31.  *
  32.  * @see {@link https://nodejs.org/dist/latest-v6.x/docs/api/buffer.html#buffer_buffer|Node.JS - Buffer}
  33.  */
  35. const Browser = require('./Browser'), stack = [ ];
  38. /**
  39.  * Puppeteer API
  40.  *
  41.  * @class
  42.  */
  43. class Puppeteer {
  44.     /**
  45.      * Launch a browser instance with given arguments.
  46.      * The browser will be closed when the parent NodeJS process is closed.
  47.      *
  48.      * @param {object}  [options]                 Set of configurable options to set on the browser
  49.      * @param {boolean} [options.headless = true] Whether to run browser in headless mode
  50.      *
  51.      * @return {Promise<Browser>}
  52.      */
  53.     static async launch({headless = true} = {}) {
  55.         return  stack[stack.push(new Browser( headless )) - 1];
  56.     }
  58.     /**
  59.      * @return {string} A path where Puppeteer expects to find Internet Explorer
  60.      */
  61.     static executablePath() {
  63.         const page = stack[0]  &&  stack[0]._page[0];
  65.         return  page  &&  (page._target.FullName + '');
  66.     }
  67. }
  70. async function clear(error) {
  72.     await Promise.all( stack.map(browser => browser.close()) );
  74.     if (error instanceof Error) {
  76.         console.error( error );
  78.         process.exit(1);
  79.     }
  81.     process.exit(0);
  82. }
  84. for (let event  of  ['uncaughtException', 'unhandledRejection', 'SIGINT', 'exit'])
  85.     process.on(event, clear);
  88. module.exports = Puppeteer;