!Repo Size


Mouselog.js
====

Mouselog.js is the client-side agent for Microsoft's Mouselog, a user behavior monitoring platform for websites.

CDN

Embed Mouselog in your HTML files:
``html


`
You can also include mouselog dynamically in Javascript:
`Javascript
(function() {
var script = document.createElement("script");
script.src = "https://cdn.jsdelivr.net/npm/mouselog@latest/build/mouselog.js";
script.onload = function() {
var agent = mouselog.init();
agent.run({
uploadEndpoint: "Your_Server_Url",
websiteId: "Your_Website_Id",
endpointType: "absolute"
});
}
document.addEventListener('DOMContentLoaded', function () {
document.body.appendChild(script);
});
})();
`

Build Manually

You can also bundle Mouselog.js manually via
`
npm i
npm run build
`
This will generate the bundled scripts in ./build.

NPM

Install Mouselog.js via
`
npm i mouselog --save
`

Then run Mouselog and it will automatically collect all you want.
`Javascript
// const { Mouselog } = require('mouselog');
import Mouselong from 'mouselog';
let agent = new Mouselog();
agent.run({
uploadEndpoint: "Your_Server_Url",
websiteId: "Your_Website_Id",
endpointType: "absolute"
});
`
You can also deactivate Mouselog by calling agent.stop().

Configuration

Username

You can set username by assigning the username to window.mouselogUserId.
`js
window.mouselogUserId = "Username"；
`
Mouselog agent will automatically load it when uploading the data to the server.

Other parameters

`js
{
// Type: string
// Endpoint Url, required
uploadEndpoint: "your_server_url",

// Type: string
// Website ID
websiteId: "unknown",

// Endpoint type, "absolute" or "relative"
endpointType: "absolute",

// Upload mode, "mixed", "periodic" or "event-triggered"
// "periodic": upload data in every period.
// "event-triggered": upload data when a number of interaction data is captured
// "mixed": the mixture of the previous two upload mode
uploadMode: "mixed",

// Type: number
// If uploadMode == "periodic", data will be uploaded every uploadPeriod ms.
// If no data are collected in a period, no data will be uploaded
uploadPeriod: 5000,

// Type: number
// If uploadMode == "event-triggered"
// The website interaction data will be uploaded when every frequency events are captured.
frequency: 50,

// Type: number | null
// Mouselog will stop uploading data after uploading uploadTimes batch data.
uploadTimes = null

// Maximum size of a single package
sizeLimit = 65535,

// Content: "base64" or an empty string
// Use a encoder before uploading the data
encoder = "";

// Type: Boolean
// Mouselog will fetch config from mouselog server during initialization if enableServerConfig == true
enableServerConfig = true;

// Type: Boolean
// Mouselog will generate session ID to track user cross-tabs behaviors if enableSession == true
enableSession = true;

// Type: Boolean
// Allow mouselog to send data without any events
enableSendEmpty = false;

// Type: bool
// Use GET method to upload data? (stringified data will be embedded in URI)
enableGet: false,

// Type: Boolean
// Not allow internal exceptions to be raised in browser's console
this.disableException = false;

// Type: string
// A global predefined variable for setting the impression ID.
// When initializing the impression ID, mouselog will try to call eval(this.impIdVariable).
// Warning: Please don't set the same impression ID variable in two different mouselog instances.
this.impIdVariable = null;

// Type: string
// A global predefined variable for setting the session ID.
// When initializing the session ID, mouselog will try to call eval(this.sessionIdVariable).
this.sessionIdVariable = null;

// Type: HTML DOM Element
// Agent only listens and captures events in config.scope
scope: window.document

// Type: Boolean
// If enablePingMessage, Mouselog will send a ping message with empty trace immediately after initialization
enablePingMessage: false

// Type: Boolean
// If recordKeyboardEvent, Mouselog will record masked keyboard event
recordKeyboardEvent: true
}
``

Demo

Mouselog-demo

Contributing

This project welcomes contributions and suggestions. Most contributions require you to agree to a
Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us
the rights to use your contribution. For details, visit https://cla.opensource.microsoft.com.

When you submit a pull request, a CLA bot will automatically determine whether you need to provide
a CLA and decorate the PR appropriately (e.g., status check, comment). Simply follow the instructions
provided by the bot. You will only need to do this once across all repos using our CLA.

This project has adopted the Microsoft Open Source Code of Conduct.
For more information see the Code of Conduct FAQ or
contact opencode@microsoft.com with any additional questions or comments.