Full documentation at api.typingdna.com*

First you need to import the typingdna.js file in the page that wants to record a typing pattern. You will need to record typing patterns when a user first creates his account and again whenever you want to authenticate that user on your platform. You can host the .js file yourself.

Alternative locations from where you can include the last class:

• https://typingdna.com/scripts/typingdna.js
• https://api.typingdna.com/scripts/typingdna.js

Once you create an instance of the TypingDNA class, the user typing starts being recorded (as a history of keystroke events). Whenever you want to get the user's typing pattern you have to invoke .getTypingPattern method described in detail below.

Returns: Returns the instance of the TypingDNA class (singleton)

Example

var tdna = new TypingDNA();

Here are the functions available in the TypingDNA class:

• Main:
• .getTypingPattern(optionsObject) ⇒ String
• Optional:
• .addTarget()
• .removeTarget()
• .start() Automatically called by default
• .stop()
• .reset()
• .getQuality(typingPattern) ⇒ Number

This is the main function that outputs the user's typing pattern as a String

Returns: A typing pattern in String form

optionsObject: An object of the following form {type:Number, text:String, textId:Number, length: Number, targetId:String, caseSensitive:Boolean}. Detail table below.

Examples

//anytext pattern
var typingPattern = tdna.getTypingPattern({type:0, length:160});
//sametext pattern
var typingPattern = tdna.getTypingPattern({type:1, text:"Hello5g21?*"});
//extended pattern
var typingPattern = tdna.getTypingPattern({type:2, text:"[email protected]"});

(Optional) Adds a target to the targetIds array. It has to be a text input or text area or any other HTML DOM element that has the .value property. You can add multiple targets (such as username and password fields).

If you omit adding targets the typing patterns will be recorded for the entire typing session.

Example

TypingDNA.addTarget(emailaddr_id)
TypingDNA.addTarget(password_id)

Remove a target from the targetIds array.

Resets the history stack of recorded typing events.

Automatically called at initilization. It starts the recording of typing events. You only have to call .start() to resume recording after a .stop()

Ends the recording of further typing events.

Checks the quality of a general typing pattern (type 0), how well it is revelated, how useful the information will be for matching applications.

Returns: Number - A real number between 0 and 1. Values over 0.3 are acceptable, however a value over 0.7 shows good pattern strength.

Example

var patternQuality = tdna.getQuality(typingPattern);

Apache License, Version 2.0