puppeteer-extra-plugin-human-typing

A puppeteer-extra plugin to add human typing to Puppeteer.

Features

• gives page the function .typeHuman() which "humanizes" the writing of input elements
• makes, up to the specified percentage chance, typos and automatically corrects them (or keeps them with a given chance)

Installation

yarn add puppeteer-extra-plugin-human-typing
# - or -
npm install puppeteer-extra-plugin-human-typing

If this is your first puppeteer-extra plugin here's everything you need:

yarn add puppeteer puppeteer-extra puppeteer-extra-plugin-human-typing
# - or -
npm install puppeteer puppeteer-extra puppeteer-extra-plugin-human-typing

Usage

The plugin adds human typing to Puppeteer.

const puppeteer = require("puppeteer-extra");

puppeteer.use(require("puppeteer-extra-plugin-human-typing")());

puppeteer.launch({ headless: false }).then(async (browser) => {
  const page = await browser.newPage();

  await page.setViewport({ height: 600, width: 800 });
  await page.goto("https://www.google.com");

  /** During initialization and also here, settings can be specified. */
  await page.typeHuman('[name="q"]', "Is a robot writing right now?", {
    backspaceMaximumDelayInMs: 750 * 2,
    backspaceMinimumDelayInMs: 750,
    maximumDelayInMs: 650,
    minimumDelayInMs: 150,
  });
});

Options

Usage:

const HumanTypingPlugin = require("puppeteer-extra-plugin-human-typing");

const humanTyping = HumanTypingPlugin({
  backspaceMaximumDelayInMs: 750 * 2,
  backspaceMinimumDelayInMs: 750,
  chanceToKeepATypoInPercent: 0,
  keyboardLayout: "de",
  keyboardLayouts: {
    de: [
      ["1", "2", "3", "4", "5", "6", "7", "8", "9", "0", "ß"],
      ["q", "w", "e", "r", "t", "z", "u", "i", "o", "p", "ü"],
      ["a", "s", "d", "f", "g", "h", "j", "k", "l", "ö", "ä"],
      ["y", "x", "c", "v", "b", "n", "m", ",", ".", "-"],
    ],
    en: [
      ["1", "2", "3", "4", "5", "6", "7", "8", "9", "0", "-"],
      ["q", "w", "e", "r", "t", "y", "u", "i", "o", "p", "["],
      ["a", "s", "d", "f", "g", "h", "j", "k", "l", ";", "'"],
      ["z", "x", "c", "v", "b", "n", "m", ",", ".", "/"],
    ],
  },
  maximumDelayInMs: 650,
  minimumDelayInMs: 150,
  typoChanceInPercent: 15,
});

puppeteer.use(humanTyping);

Available options:

const options = {
  /** The maximum delay before hitting the Backspace-button. */
  backspaceMaximumDelayInMs: 750 * 2,
  /** The minimum delay before hitting the Backspace-button. */
  backspaceMinimumDelayInMs: 750,
  /** The chance to keep a typo in percent. */
  chanceToKeepATypoInPercent: 0,
  /** The keyboard layout. */
  keyboardLayout: "de",
  /** The predefined keyboard layouts. See "Keyboard Layouts" */
  keyboardLayouts: {},
  /** The maximum delay before typing a character. */
  maximumDelayInMs: 650,
  /** The minimum delay before typing a character. */
  minimumDelayInMs: 150,
  /** The chance for a typo in percent. */
  typoChanceInPercent: 15,
};

Keyboard Layouts

A keyboard layout is a multidimensional array, built like a real keyboard. I intentionally left out some characters because I suspect that these characters are used less frequently. It is therefore important that it is set up like a real keyboard so that a suitable/correct selection can be made for "typos".

const customKeyboardLayout = [
  ["1", "2", "3", "4", "5", "6", "7", "8", "9", "0", "-"],
  ["q", "w", "e", "r", "t", "y", "u", "i", "o", "p", "["],
  ["a", "s", "d", "f", "g", "h", "j", "k", "l", ";", "'"],
  ["z", "x", "c", "v", "b", "n", "m", ",", ".", "/"],
];

const humanTyping = HumanTypingPlugin({
  keyboardLayout: "custom",
  keyboardLayouts: {
    custom: customKeyboardLayout,
  },
});