Important: This documentation covers Yarn 1 (Classic).
For Yarn 2+ docs and migration guide, see yarnpkg.com.

Package detail

@secret-agent/shared-session-state

ulixee21MIT1.0.0-alpha.3TypeScript support: included

Library to capture and store Secret Agent sessions

readme

SecretAgent

SecretAgent is a web browser that's built for scraping.

  • <input checked="" disabled="" type="checkbox"> Built for scraping - it's the first modern headless browsers designed specifically for scraping instead of just automated testing.
  • <input checked="" disabled="" type="checkbox"> Designed for web developers - We've recreated a fully compliant DOM directly in NodeJS allowing you bypass the headaches of previous scraper tools.
  • <input checked="" disabled="" type="checkbox"> Powered by Chromium - The powerful Chromium engine sits under the hood, allowing for lightning fast rendering.
  • <input checked="" disabled="" type="checkbox"> Emulates any modern browser - Emulator plugins make it easy to disguise your script as practically any browser.
  • <input checked="" disabled="" type="checkbox"> Avoids detection along the entire stack - Don't be blocked because of TLS fingerprints in your networking stack.

Check out our website for more details.

Installation

`shell script npm i secret-agent


or

```shell script
yarn add secret-agent

Usage

SecretAgent provides access to the W3C DOM specification without the need for Puppeteer's complicated evaluate callbacks and multi-context switching:

const SecretAgent = require('secret-agent');

(async () => {
  const browser = await SecretAgent.createBrowser();
  await browser.goto('https://example.org');
  const title = await browser.document.querySelector('title').textContent;
  const intro = await browser.document.querySelector('p:first-child').textContent;
  await browser.close();
})();

Browse the full API docs.

Contributing

We'd love your help in making SecretAgent a better tool. Please don't hesitate to send a pull request.

License

MIT

changelog

Change Log

All notable changes to this project will be documented in this file. See Conventional Commits for commit guidelines.

1.0.0-alpha.3 (2020-07-07)

Bug Fixes

  • mitm: small tweak for mitm tests hanging (c969870)
  • session-state: Improve page recorder perf (14f78b9), closes #8
  • .gitignore was ignoring files that were needed for website (4b9a2e4)
  • mitm timing out large bodies (d38e78f), closes #8

Features

  • dist: improve packaging for double agent (df195b6)
  • emulators: Emulator plugins - set agent (e53cedb), closes #8
  • emulators: improve page logging (cb73806)

1.0.0-alpha.2 (2020-06-27)

Bug Fixes

  • Emulator plugin referencing relative paths (f26feab)
  • missing dependencies (67504f0)

1.0.0-alpha.1 (2020-06-27)

Bug Fixes

  • Emulator plugin referencing relative paths (f26feab)

1.0.0-alpha.0 (2020-06-27)

Note: Version bump only for package secret-agent