https://github.com/techquery/puppeteer-ie

Headless Internet Explorer NodeJS API inspired by Puppeteer
https://github.com/techquery/puppeteer-ie

activex-control headless-browsers internet-explorer puppeteer

Last synced: 5 days ago
JSON representation

Headless Internet Explorer NodeJS API inspired by Puppeteer

• Host: GitHub
• URL: https://github.com/techquery/puppeteer-ie
• Owner: TechQuery
• License: lgpl-3.0
• Created: 2018-03-29T12:07:52.000Z (almost 7 years ago)
• Default Branch: master
• Last Pushed: 2024-08-19T19:07:02.000Z (5 months ago)
• Last Synced: 2025-01-12T17:06:52.047Z (11 days ago)
• Topics: activex-control, headless-browsers, internet-explorer, puppeteer
• Language: JavaScript
• Homepage: https://tech-query.me/Puppeteer-IE/
• Size: 830 KB
• Stars: 74
• Watchers: 8
• Forks: 12
• Open Issues: 7
• Metadata Files:
  • Readme: ReadMe.md
  • Contributing: Contributing.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Puppeteer-IE

Headless **Internet Explorer** NodeJS API inspired by [Puppeteer](https://pptr.dev/).

**[ Notice ]**  [Microsoft Edge](https://www.microsoft.com/en-us/windows/microsoft-edge) isn't supported by this package as it utilizes [ActiveX](https://msdn.microsoft.com/en-us/library/windows/desktop/ms693753),

whereas Edge uses the [WebDriver protocol](https://developer.microsoft.com/en-us/microsoft-edge/tools/webdriver/) & [DevTools Protocol](https://docs.microsoft.com/en-us/microsoft-edge/devtools-protocol/) for automation.

So you can control it by [Selenium](http://seleniumhq.github.io/selenium/docs/api/javascript/) or [Edge diagnostics adapter](https://github.com/Microsoft/edge-diagnostics-adapter).

[![Build Status](https://dev.azure.com/shiy2008/shiy2008/_apis/build/status/TechQuery.Puppeteer-IE?branchName=master)](https://dev.azure.com/shiy2008/shiy2008/_build/latest?definitionId=1?branchName=master)

[![NPM](https://nodei.co/npm/puppeteer-ie.png?downloads=true&downloadRank=true&stars=true)](https://nodei.co/npm/puppeteer-ie/)

## Installation

```Shell

npm install puppeteer-ie --save-dev

```

**[ Notice ]**  If you get some error at installing, try to execute the command below:

```Shell

npm install windows-build-tools --global --production

```

([More about this](https://github.com/nodejs/node-gyp#option-1))

## Usage

Only change the Package Name, and then do as [Puppeteer does](https://pptr.dev/#?product=Puppeteer&version=v1.5.0).

**[ Recommendation ]**  Use [DayDream](https://github.com/segmentio/daydream) to record operation scripts in [Google Chrome](https://www.google.com/chrome/).

**API document** accesses from https://techquery.github.io/Puppeteer-IE/, `npm docs` or `npm run help`.

## Known issue

 1. *Loading pages* of IE will be blocked if a *Web server* running in the same *NodeJS process*

 2. *Loading pages* from `localhost` will lost the `window` object in *NodeJS process*

For the above reasons, I recommend using [KoApache](https://www.npmjs.com/package/koapache) to [host your Web pages for testing](https://github.com/TechQuery/Puppeteer-IE/blob/master/test/Page.js#L19) or other things.

## Development

[Contributor guide](https://github.com/TechQuery/Puppeteer-IE/blob/master/Contributing.md)

## Acknowledgement

 1. [Puppeteer](https://github.com/GoogleChrome/puppeteer)

 2. [Node-ActiveX](https://github.com/durs/node-activex)

 3. [HTML2Canvas](http://html2canvas.hertzen.com/)