Neglected Pulse Machine

    website-scraper-puppeteer

    1.0.0 • Public • Published

    Version Downloads Node.js CI Test Coverage

    website-scraper-puppeteer

    Plugin for website-scraper which returns html for dynamic websites using puppeteer.

    This module is an Open Source Software maintained by one developer in free time. If you want to thank the author of this module you can use GitHub Sponsors or Patreon.

    Requirements

    • nodejs version >= 14.14
    • website-scraper version >= 5

    Installation

    npm install website-scraper website-scraper-puppeteer

    Usage

    import scrape from 'website-scraper';
    import PuppeteerPlugin from 'website-scraper-puppeteer';
    
    await scrape({
        urls: ['https://www.instagram.com/gopro/'],
        directory: '/path/to/save',
        plugins: [ 
          new PuppeteerPlugin({
            launchOptions: { headless: false }, /* optional */
            scrollToBottom: { timeout: 10000, viewportN: 10 }, /* optional */
            blockNavigation: true, /* optional */
          })
        ]
    });

    Puppeteer plugin constructor accepts next params:

    • launchOptions - (optional) - puppeteer launch options, can be found in puppeteer docs
    • scrollToBottom - (optional) - in some cases, the page needs to be scrolled down to render its assets (lazyloading). Because some pages can be really endless, the scrolldown process can be interrupted before reaching the bottom when one or both of the bellow limitations are reached:
      • timeout - in milliseconds
      • viewportN - viewport height multiplier
    • blockNavigation - (optional) - defines whether navigation away from the page is permitted or not. If it is set to true, then the page is locked to the current url and redirects with location.replace(anotherPage) will not pass. Defaults to false

    How it works

    It starts Chromium in headless mode which just opens page and waits until page is loaded. It is far from ideal because probably you need to wait until some resource is loaded or click some button or log in. Currently this module doesn't support such functionality.

    Install

    npm i website-scraper-puppeteer

    DownloadsWeekly Downloads

    213

    Version

    1.0.0

    License

    MIT

    Unpacked Size

    8.63 kB

    Total Files

    7

    Last publish

    Collaborators

    • s0ph1e